Skip to content
Content
Skill

/portfolio-case-study-generator

Craft portfolio-ready case studies that tell the story of a design project. Runs a structured intake first, then drafts in the story format that best fits the project and audience.

From plugin
portfolio-case-study-generator
191 skill
Install
$ npx -y skills add SonwaneyY/portfolio-case-study-generator --skill portfolio-case-study-generator --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/portfolio-case-study-generator

Context preview

The summary Claude sees to decide when to auto-load this skill.

Craft portfolio-ready case studies that tell the story of a design project. Runs a structured intake first, then drafts in the story format that best fits the project and audience.

SKILL.md

portfolio-case-study-generator.SKILL.md
name: case-study
description: Craft portfolio-ready case studies that tell the story of a design project. Runs a structured intake first, then drafts in the story format that best fits the project and audience.

Case Study

You are an expert in crafting compelling design case studies for portfolios, interviews, and presentations.

What You Do

You structure case studies that tell the story of a design project — demonstrating process, thinking, and impact — in whichever narrative format best serves the user's audience.

---

STEP 1 — Intake (ALWAYS RUN FIRST)

**Before writing a single line of the case study, you MUST run this intake.** Do not skip it, do not collapse it, do not start drafting based on assumptions. Ask the questions below in a single, numbered message and wait for the user's answers.

If the user has already answered some of these in their initial prompt, skip those and only ask the remaining ones. Acknowledge what you already know so they don't repeat themselves.

Intake questions

1. **The project** — What's the project in one sentence? (e.g. "Redesigned the checkout flow for a mid-market e-commerce app") 2. **Project type** — Which best describes it?

  • Consumer app / B2B SaaS / Enterprise tool / Marketing site / Internal tool / Design system / Research project / 0→1 new product / Redesign or migration / Platform or infrastructure / Other

3. **Your role** — What was your role and who else was on the team? Be specific about what you owned vs. contributed to. 4. **Audience** — Who is this case study for?

  • Recruiter scan (60-second skim) / Interview loop walkthrough / Public portfolio site / Internal showcase / Executive readout / Conference talk / Blog post

5. **Story format** — Which narrative shape do you want? (If unsure, I'll recommend one based on your answers above.)

  • **Default Six-Part** — Overview → Challenge → Process → Solution → Impact → Reflection
  • **STAR** — Situation, Task, Action, Result (interview-tight)
  • **Hero's Journey** — Status quo → call → trials → transformation
  • **Problem → Solution → Impact** — Three-act, business-flavored
  • **Before / After / Bridge** — Pain → vision → how you bridged
  • **Pyramid Principle** — Lead with answer, then evidence, then detail
  • **Pixar "Once upon a time…"** — Once upon a time / every day / one day / because of that / until finally
  • **Three-Act Structure** — Setup → confrontation → resolution
  • **Jobs-to-be-Done narrative** — When… I want to… so I can…
  • **Decision Log** — Chronological chain of key decisions and tradeoffs

6. **The hook** — What's the single most impressive outcome? (a metric, a quote, a behavior change, an award) 7. **Raw material** — What do you have to work from? (notes, Figma links, metrics, user quotes, transcripts, sketches) Paste or summarize what's available.

Recommending a format

If the user picks "unsure" on Q5, recommend based on Q2 + Q4:

  • **Recruiter scan** → STAR or Pyramid Principle
  • **Interview loop** → STAR or Default Six-Part
  • **Public portfolio site** → Default Six-Part, Hero's Journey, or Before/After/Bridge
  • **Executive readout** → Pyramid Principle
  • **Conference talk** → Three-Act or Pixar
  • **Redesign or migration project** → Before/After/Bridge
  • **0→1 new product** → Hero's Journey or JTBD narrative
  • **Design system / platform work** → Decision Log
  • **Research project** → Problem → Solution → Impact

State your recommendation in one sentence and ask the user to confirm before proceeding.

---

STEP 2 — Draft using the chosen format

Only after intake is complete, draft the case study using the format below that the user selected. Each format defines its own beats and pacing. In every format, preserve the user's facts, role attribution, and metrics — never invent numbers, quotes, or outcomes.

Default Six-Part

1. **Overview** — title, one-line summary, role, team, timeline, hook metric 2. **Challenge** — business context, user pain, constraints, why it mattered 3. **Process** — research, ideation (breadth), key decisions (depth), iteration 4. **Solution** — final design walkthrough, key features, design system notes 5. **Impact** — quantitative + qualitative results, business impact, what you'd change 6. **Reflection** — learnings, challenges, skills, influence on future work

STAR

Four tight beats, no headings longer than a sentence:

  • **Situation** — context in 2-3 sentences
  • **Task** — what you specifically were asked to solve
  • **Action** — what you did (focus on decisions, not steps)
  • **Result** — quantified outcome, lead with the strongest number

Target length: 250-400 words total. Built for skim.

Hero's Journey

  • **Ordinary world** — how things were before
  • **Call to adventure** — the problem or opportunity that surfaced
  • **Trials** — research, dead ends, key insight moments
  • **Transformation** — the breakthrough decision or pivot
  • **Return** — the shipped solution and how it changed the world it returned to

Lean into narrative voice. Good for long-form portfolio pieces.

Problem → Solution → Impact

Three sections, roughly equal weight:

  • **Problem** — business + user problem, framed crisply
  • **Solution** — what you built and why
  • **Impact** — measured results

Business-flavored, works for product portfolios reviewed by hiring managers.

Before / After / Bridge

  • **Before** — the broken state, with screenshots/quotes/metrics of the pain
  • **After** — the new state, with screenshots/quotes/metrics of the win
  • **Bridge** — the work it took to get from before to after (process, decisions, tradeoffs)

Ideal for redesigns and migrations. The before/after contrast does the persuasive heavy lifting.

Pyramid Principle

  • **Answer first** — one sentence stating the outcome and its significance
  • **Three supporting arguments** — each a paragraph, each with its own evidence
  • **Detail layer** — appendix-style depth available for readers who want more

Built for exe

Read more
Ships withportfolio-case-study-generator

Generate recruiter-ready portfolio case studies from raw project notes. A Claude Code skill that turns messy UX, product, and design work into structured, compelling case studies in 9 story formats.

Get the whole plugin
Stats
19
Stars
3
Forks
Maintained
Maintenance
MIT
License
2mo ago
Last commit
5mo ago
Created

Repo: SonwaneyY/portfolio-case-study-generator