Get the FREE Ultimate OpenClaw Setup Guide →

case-study-builder

Scanned
npx machina-cli add skill BrianRWagner/ai-marketing-claude-code-skills/case-study-builder --openclaw
Files (1)
SKILL.md
6.3 KB

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.


Context Loading Gates

Before generating anything, collect all 8 fields:

FieldWhat to Collect
1. ClientIndustry, company size/stage, named or anonymized?
2. BeforeWhat was broken or painful? Any numbers?
3. ActionsWhat did you specifically do? Scope, timeline, role
4. AfterREQUIRED: at least one specific number
5. TimelineHow long to achieve the result?
6. QuoteDirect client quote if available
7. NamingCan we name the client, or must we anonymize?
8. Use caseWhere 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:

  1. 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.
  2. Hero check: Is the story told from the client's perspective, or yours? Client = hero, you = guide.
  3. Tension check: What made this hard? Without a challenge, there's no story — just a list.
  4. Format match: Which use case did they specify? That determines which format to optimize.

Tier system for results language:

TierTypeExampleLanguage
1Hard metric"Revenue +40%"State directly
2Soft metric"Team finally aligned""For the first time in years..."
3Proxy metric"Enabled Series A close""Contributed to..."
4Directional"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

FormatBest locationsWhen to use
Two-linerProposals, email bios, LinkedIn About sectionAny sales context
StoryLinkedIn post, podcast intros, sales call openerWeekly content
Full case studyWebsite portfolio page, PDF download, RFP responseLate-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

Source

git clone https://github.com/BrianRWagner/ai-marketing-claude-code-skills/blob/main/case-study-builder/SKILL.mdView on GitHub

Overview

Turn client wins into polished, reusable case studies for proposals, websites, and social proof. Gather 8 essential details, then generate three formats: a Two-Liner, a Story Version, and a Full Case Study. This helps document results, build credibility, and accelerate sales conversations.

How This Skill Works

Collect 8 required fields (Client, Before, Actions, After, Timeline, Quote, Naming, Use case) before drafting. Ensure Field 4 (After) includes a concrete metric. Then generate three formats tailored to the use case: Two-Liner for proposals, Story Version for LinkedIn and sales calls, and a Full Case Study for websites and portfolios, always framing the client as the hero.

When to Use It

  • When you need documented results for proposals, pitches, or RFP responses
  • When you want credible social proof on your website or LinkedIn profile
  • When creating reusable proof assets for sales playbooks and onboarding
  • When a project has tangible outcomes and a client quote is available
  • When you need to respect client naming preferences (named or anonymized) while showcasing impact

Quick Start

  1. Step 1: Collect 8 fields for your client: Client, Before, Actions, After, Timeline, Quote, Naming, Use case
  2. Step 2: Verify After contains a concrete number and decide the target format based on use case
  3. Step 3: Generate three formats (Two-Liner, Story Version, Full Case Study) and deploy to proposals, LinkedIn, and website

Best Practices

  • Collect all 8 required fields up front before drafting
  • Require a concrete metric in Field 4 (After) to ensure credibility
  • Write from the client’s perspective (client as hero) using the Hero Principle
  • Match the format to the intended use case (proposals, LinkedIn, website)
  • Include a direct client quote when available and honor naming/anonymization preferences

Example Use Cases

  • Two-Liner 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.
  • Story Version example: 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.
  • Full Case Study example: Case Study: [Client Name] — The Challenge; The Approach; The Outcome; Includes measurable results and a client quote.
  • Proposal-ready example: A concise, action-oriented Two-Liner tailored for an RFP, followed by a mini-Story Version for quick context.
  • Website/Portfolio excerpt: A skimmable case study section with The Challenge, The Approach, and The Outcome sections, plus a highlighted quote

Frequently Asked Questions

Add this skill to your agents
Sponsor this space

Reach thousands of developers