Skip to main content
skill CX Codex

case-study · jakeschincariol — Claude Code skill: customer stories and setup

A skill for Claude Code drafts a customer case study from real figures and the customer's own words. It runs when asked for a testimonial or customer story after delivery.

MIT ★ 92 updated 2026-11-06

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add Jakeschincariol/whale-skill
/plugin install whale-skill@whale-skill
Open on GitHub

What case-study does

The skill writes a short before-and-after account from customer-provided figures and saves it as a draft in whale/case-studies/<deal>.md. The draft needs the before and after numbers, their source, and an actual customer quote. The deal must be marked delivered.

The casestudy.py script creates drafts, records written approval, and checks the text before use. Approval applies to that exact version; an edit requires the customer to approve it again. Running the script requires python3.

The skill does not invent figures or quotes, or send material without the user's explicit consent and the customer's written approval. A customer who declines ends the process.

What it helps with

  • draft a case study from a customer's results
  • record approval of the exact text
  • check whether approved copy has changed
  • keep a pre-delivery payment from being presented as a result

Example prompts for the agent

  • Draft a case study for deal north-pier using the customer's real figures and quote.
  • Record the customer's written approval for the case study on deal north-pier.
  • Check whether the current case study for north-pier matches its approved version.

How to install case-study

1Plugin marketplace

/plugin marketplace add Jakeschincariol/whale-skill
/plugin install whale-skill@whale-skill

This installs the whole whale-skill plugin with all its skills

2Skills CLI (Vercel)

npx skills add Jakeschincariol/whale-skill --skill case-study -a claude-code

3Manually: put the files in place

~/.claude/skills/case-study/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/case-study/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about case-study

How do I install case-study in Claude Code?

Run /plugin marketplace add Jakeschincariol/whale-skill, then run /plugin install whale-skill@whale-skill.

What does case-study do?

It drafts a customer story from real figures and a quote, records the customer's written approval, and checks the copy before use. Any changed version needs fresh approval.

What does case-study need to run?

It requires python3, and the deal must be marked delivered. The case study also needs customer data and written approval of the exact text.

Source text

SKILL.md · MIT
---
name: case-study
description: >-
  Case Study. Turns the first customer into proof, with their permission. Once the product has shipped, it
  writes a short before-and-after from their real numbers and their real words, and keeps it marked as a
  draft until they have approved that exact text in writing. Change a word and it asks again. Use when the
  user says "case study", "testimonial", "customer story", "get a quote from them", "write up the result",
  "social proof", "can I use their name", or once a customer has seen results.
argument-hint: "[draft <deal> | approve <deal> | check <deal>]"
---

# case-study

Before you have customers, you sell on the demo and the refund. After you have one, you sell on them. One real
story, with a name and a number, is worth more than anything you could write about yourself. But it's a claim
about a real company, so it has to be true and it has to be theirs to give.

`${CLAUDE_SKILL_DIR}` below is this skill's folder (where this SKILL.md lives).

```bash
python3 "${CLAUDE_SKILL_DIR}/casestudy.py" draft --deal north-pier --before "Paid \$6,400 a month to chase invoices" \
    --after "Cancelled the collections service" --source "North Pier's own numbers, Jan 2027" \
    --quote "We stopped thinking about late invoices." --quote-by "Renee Alvarez, CFO"
python3 "${CLAUDE_SKILL_DIR}/casestudy.py" approve --deal north-pier --said "Approved, go ahead." --at 2027-02-10
python3 "${CLAUDE_SKILL_DIR}/casestudy.py" check --deal north-pier
```

## Steps

1. **Wait for a result.** `draft` refuses until the deal is `delivered` (`/pre-sale deliver`). Give it long enough to have a real number.
2. **Ask first.** "Send this to Renee: would you be open to a short write-up, if you approve every word? Reply yes or no." A no is fine, and it ends here.
3. **Get the real numbers from them.** Before and after, and where they came from. Ask what changed, in their words: "What's different now?"
4. **Draft.** `casestudy.py draft`. It writes `whale/case-studies/<deal>.md` with a DRAFT line at the top. Keep it under 150 words. A quote is what they
   actually said or wrote, word for word, with their name. Don't tidy it into something they wouldn't say.
5. **Send them the exact text.** "Send this to Renee for approval? Reply yes or no."
6. **Log their approval.** `casestudy.py approve --said "<their words>"`. It removes the DRAFT line, for this text only.
7. **Check before every use.** `casestudy.py check`. If the text changed after they approved it, it says to ask again.
8. **Use it.** On the next pitch, in `/offer-builder`, on the launch page. Only then does the "you'd be one of the first" answer in `/objection-handler` change.

## What makes it believable

- **A real name and a real company,** if they agree. If they'd rather not be named, say "a regional freight company" and keep the number.
- **One number.** "Cancelled a $6,400-a-month service" beats a list of adjectives.
- **The bad part.** What was hard before, or what took longer than expected. It's how people know it's true.
- **Typical, or not.** If one customer's result is unusually good, don't suggest everyone gets it. The FTC treats testimonials as claims you must be able to back up.

## Example from the reel's board

After North Pier Logistics has the product: Before, paid $6,400 a month to chase invoices. After, cancelled the collections service. Quote: "We stopped
thinking about late invoices." Renee Alvarez, CFO. It stays a draft until Renee approves it. (Illustrative: this result and this quote are made up to show
the format, and North Pier and Renee are fictional. Your case study uses only what your customer gives you.)

## What it never does

- Never writes a case study before delivery, and never makes up a quote, a number or a logo.
- Never publishes or sends anything without a yes, and never uses a draft their approval doesn't cover.
- Never presents a pre-sale payment as a result. "They paid" is not "it worked".

## Consent and truth

- Nothing is sent or published without the user's explicit yes for that exact message, and the customer's written approval of that exact text. One yes per message. Never "yes to all".
- Stop at the first "no". Not wanting a case study never affects how the customer is treated.
- Never invent a number, a result, a client or a quote. If they withdraw their approval, take it down.

© Jake Schincariol · MIT · Jakeschincariol/whale-skill

Similar skills

SKILL.md skills catalog →

case-study by other authors comes first.

case-study Owl-Listener case-study structures design portfolio case studies around process evidence, personal contribution, and business metrics. Built for presenting projects to external audiences. CX Codex +1 2,600installs developer-case-study Samuel Berthe developer-case-study turns a customer interview and their production numbers into a technical case study engineers will believe, with a before-and-after architecture and a limitations section. CX Codex +1 13,500installs portfolio-case-study-writer Paramchoudhary portfolio-case-study-writer turns resume bullets into full portfolio case studies, with a fixed structure and worked examples. Useful when building a project site. CX Codex +1 11,100installs k2f-case-study suzheng k2f-case-study outlines portfolio and client case studies from project notes and resume bullets, preparing a structured blueprint for the K2F export engine. CX Codex +1 653installs case-study-writing 101-skills case-study-writing guides drafting B2B case studies using the STAR method, metric comparisons, customer quotes, and chart visuals. CX Codex +1 242installs case-study-builder BrianRWagner case-study-builder converts customer milestones into ready-to-use case study assets for proposals, pitches, and web pages. It forces you to back up claims with real numbers. CX Codex +1 ★ 461repo stars ux-case-study Laith Aljunaidy ux-case-study generates a strict monochrome project case study with fixed (A)–(G) sections. Useful for documenting shipped deliverables after a milestone or launch. CX Codex +1 ★ 110repo stars

From the same set12

The whole set →
pricing This Claude Code skill calculates a price from what a customer already spends on the problem. Ask for pricing options, a check of a proposed amount, or a price saved to a deal. CX Codex +1 ★ 92repo stars demo-builder The demo-builder Claude Code skill turns a short spec into an interactive product demo. It activates for requests to mock up a product or show how a workflow could work. CX Codex +1 ★ 92repo stars offer-builder The offer-builder Claude Code skill drafts a one-page offer with its price, delivery date, and refund terms. It activates on requests to write an offer, prepare a proposal, or answer a prospect asking for details. CX Codex +1 ★ 92repo stars requirements The requirements Claude Code skill turns paying customers’ requests into a ranked feature list. It activates after a customer pays or when the conversation turns to scope, specs, or feature requests. CX Codex +1 ★ 92repo stars launch-planner The launch-planner Claude Code skill schedules a product launch after a customer pays. It works back from the promised delivery date and holds the public release until customer orders are fulfilled. CX Codex +1 ★ 92repo stars objection-handler The objection-handler Claude Code skill drafts replies to sales objections using the terms of your deal. It activates when someone pushes back, asks a question, or sends a message you’re unsure how to answer. CX Codex +1 ★ 92repo stars follow-up This Claude Code skill tracks follow-ups after a pitch or offer. It lists deals due for a message, drafts one, then waits for approval before sending. CX Codex +1 ★ 92repo stars market-researcher The market-researcher Claude Code skill finds business problems that already have a budget. It responds to requests for product ideas, market research, and idea validation. CX Codex +1 ★ 92repo stars

Project sponsors

Companies that keep this analytics open