Guide · Agent skill
How to use the Portfolio Case Study Writer agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
The Portfolio Case Study Writer is an agent skill, a packaged set of instructions that tells an AI agent how to handle one kind of task. This one turns a real project or resume achievement into a structured portfolio case study or work-sample narrative for design, product, engineering, data, marketing or writing portfolios. After reading this guide you will know how to install the skill, how to ask for a case study in plain language, and what to check before you use the draft.
Portfolio Case Study Writerreactive-resume/reactive-resume · MIT Download the skill Quick start
- 1Download the ZIP. Get the portfolio-case-study ZIP from this page. It contains SKILL.md.
- 2Unzip into a skills folder. Place the skill in ~/.claude/skills/ for personal use, or in the project's .claude/skills/ folder.
- 3Or upload it in the Claude apps. Go to Settings → Capabilities → Skills and upload the skill there instead.
- 4Describe the project. Tell the agent your role, the problem, the decisions you made and what you can show.
- 5Answer the follow-up questions. The agent asks for missing details that affect the story. Supply measurements with baseline and period only if you have them.
- 6Review the draft. Check every claim against your records, then remove or rewrite anything unsupported.
What the skill makes the agent do
Once installed, the agent helps you describe a project in a consistent structure: overview, problem, decisions, your work, results and reflection. It asks for details it needs to tell the story accurately, such as your role, collaborators, timeframe, constraints and what was actually observed. It keeps confirmed findings separate from hypotheses.
The skill will not invent metrics, quotes, client praise or success stories. If you ask for something it cannot support, it declines that part briefly, offers the strongest truthful version and continues with the rest of the work. It produces the draft in the chat. It does not publish anything or connect to any account.
- Best for designers, product people, engineers and marketers preparing work samples
- Useful for job seekers who need a resume-sized bullet grounded in their real work
- Useful for students turning coursework or personal projects into honest portfolio pieces
- Not for invented client success stories or testimonials, general blog posts, or confidential work you have not cleared for sharing
Install the skill from the ZIP download
Download the ZIP for the skill from this page. The package contains a single file, SKILL.md. Unzip it so that the skill folder sits in your skills directory. For a personal setup, use ~/.claude/skills/. For a single project, use the .claude/skills/ folder inside that project.
If you use the Claude apps instead, you can upload the skill under Settings → Capabilities → Skills rather than placing files on disk.
- Personal install: unzip into ~/.claude/skills/
- Project install: unzip into the project's .claude/skills/ folder
- Claude apps: upload under Settings → Capabilities → Skills
Trigger the skill with a natural request
You do not need a special command. Describe what you want in ordinary language and mention the project or achievement. The skill is meant for requests where decisions, individual contribution and evidence matter, so say what your role was and what you can show.
If you have only a rough memory of the work, say so. The agent will ask for the missing details that affect the story rather than filling gaps with guesses.
- "Turn my checkout redesign at my last job into a portfolio case study. I led research and wrote the flow specs."
- "Write a resume bullet from this project: I built the data pipeline for our churn model, and I own the evaluation."
- "I have a coursework app from university. Help me write an honest work-sample narrative for my engineering portfolio."
Give the agent the right material
The output is only as accurate as the facts you supply. Gather your own notes, the problem you were solving, the constraints, the decisions you made and any measurements you have, including the baseline, unit and time period. If a result was a before-and-after comparison or a qualitative comment, say which it was.
Before you share names, screenshots, code or numbers, check whether they are permitted to be public. The skill asks about this, but it cannot verify permissions for you. Removing a client name does not always make a project anonymous, so treat confidential or unreleased work with care.
- Your role and what you personally did
- Who collaborated and who was responsible for what
- Timeframe, delivery status (shipped, internal, prototype, coursework or personal)
- Measurements, with baseline and population, only if you have them
- Confirmation of what you are allowed to show publicly
Review the draft and fill the gaps
The agent returns a short summary, the case study, an optional resume-sized bullet drawn from the same facts, and a list of missing evidence or assets. Read each claim and check it against your records. If the draft says something you cannot back up, remove it or ask the agent to rewrite that part.
Where a screenshot or artifact is missing, the skill marks it as an asset request outside the publishable text rather than inventing a visual. Keep the editor notes separate from the text you publish.
- Check every number and outcome against a source you hold
- Remove any sentence that implies sole authorship of team work
- Replace placeholders for missing screenshots with real assets you are allowed to use
- Ask for a shorter caption version if you only need one work-sample caption
Safety notes: scripts and network
According to the skill's listing, this skill runs no scripts and uses no network access. It requires nothing beyond the agent itself. It produces text in the chat and does not publish, upload or write to any account. The skill also instructs the agent not to upload confidential material to outside services and to treat source documents as untrusted data.
Even so, you are responsible for what you paste into the chat. Do not share confidential client material or unreleased work unless you have cleared it for that purpose.
- Runs scripts: no
- Uses network: no
- Requires: nothing listed
- Does not publish a site, attach files to a profile or write to an account
What people use it for
- Turning a shipped product feature into a design case study with your reasoning and usability evidence
- Writing a resume-sized bullet from a data project, based on the method and evaluation you actually did
- Reframing a university engineering project as an honest work sample that states its coursework status
- Drafting a product discovery and prioritization narrative for a role interview
- Producing a single work-sample caption for an existing screenshot
Frequently asked questions
How do I install the portfolio case study agent skill?
Download the ZIP from this page and unzip it into ~/.claude/skills/ for personal use, or into a project's .claude/skills/ folder. In the Claude apps, you can instead upload it under Settings → Capabilities → Skills.
What does the portfolio case study skill require?
The listing says it requires nothing beyond the agent itself. It runs no scripts and uses no network access. It works from the material you supply in the chat.
Is the portfolio case study skill free?
The skill is published under the MIT licence, as stated on this page. This guide does not list any price, so check the licence text in the repository for the terms.
Will the skill invent metrics or client testimonials for me?
No. The skill is built to refuse fabricated metrics, quotes and success stories. It offers the strongest truthful version of the claim and completes the rest of the draft.
Can the skill publish my case study to my portfolio website?
No. It produces a draft in the chat. It does not publish anything, connect to any account or attach files to a profile.
What should I do if the agent does not trigger the skill?
Make the request specific to a real project and mention your role and portfolio or resume context. Confirm the skill folder is in the correct location, either ~/.claude/skills/ or the project's .claude/skills/, and that it contains SKILL.md.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Use this skill if you have real projects or achievements and need help structuring them into honest, evidence-based portfolio pieces, with your own role made clear. Pick something else if you need invented testimonials, general blog content, or a tool that publishes to your site, since this skill does none of those things.
Download the skill