mcpbeat Sign in

Case Study Builder Skill for Claude

Turn client wins into formatted case studies for proposals, social proof, and sales conversations. Use when someone needs to document results, build credibility, or create reusable proof assets.

2k tokens
context cost
the whole folder, loaded on every use
2
files
instructions only
0
copies elsewhere
how many repositories repackaged it
386
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/BrianRWagner/ai-marketing-claude-code-skills --skill case-study-builder

The instruction itself

12 sections, as written by the author

Case Study Builder

Everyone wants social proof. Nobody makes time to create it. You finish a project, the client's happy, you move on — and six months later you're in a sales call with nothing to show.

This skill fixes that. Give me the raw details. I'll produce three formats you can use immediately.


Mode

Detect from context or ask: *"Quick writeup, full case study, or full asset package?"*

| Mode | What you get | Best for |

|------|-------------|----------|

| quick | 1 format: paragraph summary for proposals | Fast social proof, proposal inserts |

| standard | 3 formats: proposal blurb, social proof pull-quote, sales story | Active pitching, LinkedIn, website |

| deep | 3 formats + blog-ready case study + FAQ variant + campaign assets | Content marketing, SEO, sales enablement |

Default: standard — use quick if they say "just need something fast." Use deep if they want to turn the win into a marketing asset.


Context Loading Gates

Before generating anything, collect all 8 fields:

| Field | What to Collect |

|---|---|

| 1. Client | Industry, company size/stage, named or anonymized? |

| 2. Before | What was broken or painful? Any numbers? |

| 3. Actions | What did you specifically do? Scope, timeline, role |

| 4. After | REQUIRED: at least one specific number |

| 5. Timeline | How long to achieve the result? |

| 6. Quote | Direct client quote if available |

| 7. Naming | Can we name the client, or must we anonymize? |

| 8. Use case | Where will this be used? (proposals / website / LinkedIn) |

Outcome Extraction Protocol — enforced on Field 4:

If the user says "results were good" or "things improved," stop and ask:

> "I need at least one number to make this credible. Pick one:

> - Revenue change (e.g., 'closed 3 new clients worth $15K')

> - Time saved (e.g., 'cut from 10 hours to 2 hours/week')

> - Lead volume (e.g., 'went from 0 to 5 inbound leads/month')

> - Rough estimate is fine — it doesn't have to be exact."

Do not draft until Field 4 has at least one number.


Phase 1: Situation Analysis

Before drafting, reason through:

  • Result strength: Is the outcome a Tier 1 (hard metric), Tier 2 (soft metric), or Tier 3 (proxy)? This determines how confident the language should be.
  • Hero check: Is the story told from the client's perspective, or yours? Client = hero, you = guide.
  • Tension check: What made this hard? Without a challenge, there's no story — just a list.
  • Format match: Which use case did they specify? That determines which format to optimize.

Tier system for results language:

| Tier | Type | Example | Language |

|---|---|---|---|

| 1 | Hard metric | "Revenue +40%" | State directly |

| 2 | Soft metric | "Team finally aligned" | "For the first time in years..." |

| 3 | Proxy metric | "Enabled Series A close" | "Contributed to..." |

| 4 | Directional | "Noticeable improvement" | "Significant improvement in..." |


Phase 2: The Hero Principle

The client is the hero. You are the guide.

Before writing, flip the framing:

❌ Wrong: "I built a content system that generated leads."

✅ Right: "Sarah went from scrambling to fill her pipeline to getting 3 inbound inquiries per week — all from a content system we built in 6 weeks."

Every format should be written from what the CLIENT experienced, not what YOU delivered.


Phase 3: Generate Three Formats

Format 1: Two-Liner (Proposals & Bios)

Formula: [What was done] + [scale/scope] + [for who] + [result or timeframe]

[Strong action verb] [what was delivered] for [specific client descriptor].
[Outcome metric] in [timeframe].

Example:

> Built a full content system for a Series B SaaS founder with no marketing team.

> 0 to 3 inbound leads/week in 6 weeks.


Format 2: Story Version (LinkedIn & Sales Calls)

Structure — 4 paragraphs, 150–250 words:

**Set the scene:** [Their situation when you arrived — 2-3 sentences with stakes]

**Show the complexity:** [What made this hard — 2-3 sentences]

**What happened:** [Specific actions taken — no feature lists, just moves]

**What changed:** [Outcome — the number + the transformation]

Format 3: Full Case Study (Website & Portfolio)

# Case Study: [Client Name or Descriptor]

## The Challenge
[2-3 paragraphs: situation, stakes, what wasn't working]

## The Approach
[Phases or steps — what happened and in what order]

## The Results
[Metrics, before/after comparison, named outcomes]

## Key Details
- Client: [Named or "A [descriptor] company"]
- Industry: [Sector]
- Timeline: [Duration]
- Scope: [What was delivered]

## What Made This Different
[Unique angle, unexpected obstacle, or pivotal insight]

## Client Quote
> "[Testimonial — or placeholder if not yet collected]"
> — [Name], [Title]

Phase 4: Self-Critique Pass (REQUIRED)

After generating all three formats, evaluate:

Two-liner:

  • [ ] Does it have a specific number? (Not "improved results" — a real metric)
  • [ ] Is it 2 sentences or fewer?
  • [ ] Would someone scanning a proposal stop and read it?

Story version:

  • [ ] Is the client the hero (not the author)?
  • [ ] Is there genuine tension — something that made this hard?
  • [ ] Does the closing paragraph include the key metric?

Full case study:

  • [ ] Does the Results section lead with numbers?
  • [ ] Is the Challenge section specific enough that a similar prospect recognizes their situation?
  • [ ] Is the client quote (or placeholder) present?

Flag any failure: "The story version has no tension — add one obstacle or unexpected challenge before the 'What happened' paragraph."


Phase 5: Distribution Plan

| Format | Best locations | When to use |

|---|---|---|

| Two-liner | Proposals, email bios, LinkedIn About section | Any sales context |

| Story | LinkedIn post, podcast intros, sales call opener | Weekly content |

| Full case study | Website portfolio page, PDF download, RFP response | Late-stage buyer research |


Output Structure

## Case Study: [Client Descriptor] — [Date]

### Situation Summary
[2-sentence analysis from Phase 1]
Result tier: [1/2/3/4]

---

### Format 1: Two-Liner
[Final copy]

### Format 2: Story Version
[Final copy]

### Format 3: Full Case Study
[Full markdown]

---

### Self-Critique Notes
- Two-liner: [pass/issue]
- Story: [pass/issue]
- Full: [pass/issue]

### Distribution Plan
[Where to use each]

### Next Step
[If no quote collected → run testimonial-collector]
[If strong story → suggest LinkedIn post from story format]

Cross-reference: If a client quote was captured here, run testimonial-collector to properly format and score it for your testimonial library.


*Skill by Brian Wagner | AI Marketing Architect | brianrwagner.com*

Other skills for the same job

different authors, same section of the catalogue
DOCX
by anthropics
vendor ×16

Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. When Claude needs to work with professional documents (.docx files) for: (1) Creating new documents, (2) Modifying or editing content, (3) Working with tracked changes, (4) Adding comments, or any other document tasks

7k tokens
PDF
by anthropics
vendor ×16

Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms. When Claude needs to fill in a PDF form or programmatically process, generate, or analyze PDF documents at scale.

13k tokens scripts
PPTX
by JayZeeDesign
×15

Presentation creation, editing, and analysis. When Claude needs to work with presentations (.pptx files) for: (1) Creating new presentations, (2) Modifying or editing content, (3) Working with layouts, (4) Adding comments or speaker notes, or any other presentation tasks

308k tokens scripts
Canvas Design
by anthropics
vendor ×13

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

1388k tokens
PDF
by anthropics
vendor ×10

Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.

15k tokens scripts
DOCX
by w95
×6

Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.

5k tokens
PPTX
by w95
×4

Use this skill any time a .pptx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates, layouts, speaker notes, or comments. Trigger whenever the user mentions \"deck,\" \"slides,\" \"presentation,\" or references a .pptx filename, regardless of what they plan to do with the content afterward. If a .pptx file needs to be opened, created, or touched, use this skill.

2k tokens
Obsidian Markdown
by ZhanlinCui
×3

Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax. Use when working with .md files in Obsidian, or when the user mentions wikilinks, callouts, frontmatter, tags, embeds, or Obsidian notes.

3k tokens

How to use it

Copy the folder

Take brianrwagner/case-study-builder from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.