Agent skill

Case Studies

by ericrisco in ericrisco/rsc-harness

A skill your agent uses when turning one named customer's measured win into a case study, or the attributed testimonial quote that travels with it — consent-cleared, metrics-anchored proof for the…

MITAuto-check passedWriting & Content

Install Case Studies

skills CLI
$ npx skills add ericrisco/rsc-harness --skill case-studies -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ericrisco/rsc-harness case-studies --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ericrisco/rsc-harness.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/case-studies .claude/skills/case-studies && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
case-studies
GitHub stars
156
Token cost
~2.8k tokens
SKILL.md length
1,457 words
Files
6 (incl. scripts, references)
Skills in repo
229
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when turning one named customer's measured win into a case study, or the attributed testimonial quote that travels with it — consent-cleared, metrics-anchored proof for the…

  • Works in 7 steps: Results headline — one KPI, the single… → Snapshot box — above the fold: industry,… → Challenge — the measurable pain before,… → …
  • Turning one named customers measured win into a case study
  • SKILL.md covers What this produces / route out…, The intake gate — STOP if any…, The legal + consent floor and Case-study anatomy, plus 5 more sections
  • Runs Shell scripts from its folder

What it does

Case Studies is an agent skill from ericrisco/rsc-harness. Use when turning one named customer's measured win into a case study, or the attributed testimonial quote that travels with it — consent-cleared, metrics-anchored proof for the next skeptical buyer. NOT the deck that sells the vision to a room (that is pitch-deck), NOT thought-leadership with no single named customer (that is article-writing).

Its SKILL.md is about 2.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including scripts and reference files (for example `evals/README.md`, `evals/cases.yaml` and `references/case-study-skeleton.md`).

It sits in Writing & Content, covering Fundraising and pitch decks and Blog and article writing. The repository describes itself as: Your agent invents things because it has no memory, and can't touch your database because it has no arms. rsc is the meta-harness that gives it both, plus the trade to know the… The licence is MIT.

When your agent uses it

  • Turning one named customers measured win into a case study
  • The attributed testimonial quote that travels with it — consent-cleared
  • Metrics-anchored proof for the next skeptical buyer

Example prompts

  • “/case-studies”

Requirements

  • A Bash shell

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Results headline — one KPI, the single most important number. Why: it is the only line many readers see. "Fraud cut to 0.10% in 8 weeks,"…
  2. Snapshot box — above the fold: industry, region, products used, and the headline KPIs. Why: a skeptical buyer self-qualifies in seconds…
  3. Challenge — the measurable pain before, in the customer's words. Why: the buyer must see their own problem to care about the fix.
  4. Solution — what was implemented and how, concrete and specific. Why: vague "we partnered closely" proves nothing; "migrated 1,200 SKUs to…
  5. Result — the before/after numbers with timeframe, as Context-Achievement-Relevance lines (below). Why: this is the proof the whole piece…
  6. Attributed quote — named + title + company, one specific claim. Why: the human voice is the conversion lever, and the quote is what…
  7. Decision-stage CTA — one next step matched to where the reader now is ("See pricing," "Book a 20-min fit call"). Why: proof with no next…

What it can do on your machine

Read from SKILL.md and the folder at commit 92fde8f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Shell), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Case Studies loads about 2.8k tokens when it runs, and up to ~4.7k if it reads all its reference files. Until then it costs about 91 tokens; SKILL.md has 1,457 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~91
When it runs · the whole SKILL.md, loaded when a task matches
~2.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from ericrisco/rsc-harness at commit 92fde8f, republished under its MIT licence (© ericrisco). 1,457 words, ~2,822 tokens.

Download SKILL.mdSave it as .claude/skills/case-studies/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
case-studies
description
Use when turning one named customer's measured win into a case study, or the attributed testimonial quote that travels with it — consent-cleared, metrics-anchored proof for the next skeptical buyer. NOT the deck that sells the vision to a room (that is `pitch-deck`), NOT thought-leadership with no single named customer (that is `article-writing`).
tags
case-study, testimonial, social-proof, customer-story, conversion
recommends
pitch-deck, article-writing, retention, review-management, brand-voice, landing-copy
origin
risco

case-studies

You write the consent-cleared, metrics-anchored story of a customer who already won — and the short attributed quote that travels with it. Your reader is the next skeptical buyer, not your own marketing team. Every line either advances that buyer's decision or it is cut.

A case study is a proof artifact, not a brochure. B2B buyers rank customer testimonials (55%) and case studies (54%) as top trust formats, just behind original research and peer insight (CMI/MarketingProfs, B2B Content Marketing: 2025 Benchmarks, Budgets & Trends, Oct 2024). They are reading to de-risk a purchase. A page that praises the vendor and hides the numbers fails that job no matter how polished the prose.

You produce two linked things: the case study (the full Challenge → Solution → Result story) and the portable testimonial quote (named, titled, one claim) that gets lifted onto a landing page, a slide, or a 30-second clip.

What this produces / route out first

If the request is not a single customer's measured outcome, hand it off before you write a word.

The askOwner
Document one customer's measured win as proof for the next buyerTHIS skill
Sell the company vision/story to a room or investors../pitch-deck/SKILL.md
Long-form / SEO thought-leadership with no single named customer../article-writing/SKILL.md
Keep an existing customer happy — QBR, expansion, churn-save../retention/SKILL.md
Solicit or reply to public reviews / ratings../review-management/SKILL.md
The reusable cross-channel tone-of-voice rules../brand-voice/SKILL.md
Drop the proven quote into a converting page../landing-copy/SKILL.md
Price the offer this win justifiespricing

The one-sentence call: it is a case study if a real, named customer already got a measured result and consented to be quoted.

The intake gate — STOP if any of these is missing

Do not start prose until you have all three. A missing piece is a gathering task or an anonymization decision, never an invention.

  • The metric set — baseline, result, timeframe, and a money figure if the customer permits it. Why: a number with no baseline or timeframe is a claim, not a result. "Increased revenue" is unfalsifiable; "€420k → €1.6M in 11 months" is proof.
  • The named source — a real person with title and company for the quote. Why: an anonymous "— a happy client" reads as fabricated and a same-industry, named quote lifts lead quality far more than a generic one.
  • The consent status — written sign-off to publish the name, quote, logo, and numbers. Why: publishing an un-consented named customer is the legal failure mode, not a style miss (see below).

If you lack a metric → ask for it or do not claim it. If you lack consent → anonymize honestly ("a 200-seat logistics SaaS") or do not ship. Never round a vague number up to look better.

This is the hard floor, not a nicety. The FTC Consumer Reviews and Testimonials Rule has been in force since 21 October 2024, with penalties up to ~$53,088 per violation (the FTC's max is inflation-adjusted annually — this is the figure effective 17 Jan 2025; re-check FTC.gov before quoting it as current).

  • Real customer, honest statement. No fabricated, scripted, or insider testimonial presented as an ordinary customer. If the speaker is an employee, investor, or affiliate, you must add a clear-and-conspicuous material-connection disclosure or drop the quote.
  • Substantiation. You may not publish a metric you cannot back with a source. If you cannot point to the data, the number does not go in.
  • Written consent, kept. Get sign-off before publishing the name, exact quote, logo, image, and figures. An email confirmation suffices, but it must be retained.
  • Edit the quote only with approval. You may tighten a quote for clarity, but the customer must approve the edited wording — you cannot change what they meant.

Carry the consent state in the artifact's front-matter so it is impossible to ship a story whose status is unknown:

yaml
---
customer: "Acme Logistics"
consent: signed          # signed | pending | anonymized
approved: 2026-05-28     # date the customer signed off on the exact quote
quote_source: "interview-2026-05-20.txt"
---

consent: pending means draft-only. consent: anonymized means no name/logo/identifying detail ships. Only consent: signed may publish a named, quoted, imaged customer. Full intake form, consent/release checklist, approval-email wording, substantiation and insider-disclosure notes, and the anonymization fallback rules live in references/consent-and-substantiation.md.

Case-study anatomy

Write the sections in this order. Each earns its place; cut anything that does not advance the buyer's decision. Target 600–1,200 words — long enough to prove the result, short enough that a busy buyer finishes it.

  1. Results headline — one KPI, the single most important number. Why: it is the only line many readers see. "Fraud cut to 0.10% in 8 weeks," not the customer's company name.
  2. Snapshot box — above the fold: industry, region, products used, and the headline KPIs. Why: a skeptical buyer self-qualifies in seconds ("same industry as us? same size?").
  3. Challenge — the measurable pain before, in the customer's words. Why: the buyer must see their own problem to care about the fix.
  4. Solution — what was implemented and how, concrete and specific. Why: vague "we partnered closely" proves nothing; "migrated 1,200 SKUs to the new pricing engine in two sprints" proves capability.
  5. Result — the before/after numbers with timeframe, as Context-Achievement-Relevance lines (below). Why: this is the proof the whole piece exists to deliver.
  6. Attributed quote — named + title + company, one specific claim. Why: the human voice is the conversion lever, and the quote is what travels onto other surfaces.
  7. Decision-stage CTA — one next step matched to where the reader now is ("See pricing," "Book a 20-min fit call"). Why: proof with no next step wastes the intent it just built.

The ordered skeleton and a filled mini-example with real-shaped numbers are in references/case-study-skeleton.md.

Show full SKILL.md (544 more words)Show less

Metrics-first

Collect the numbers before you write any prose. The story is built around the data, not decorated with it.

Write each result as a Context → Achievement → Relevance line: what changed, the measured lift, and what it was worth.

text
Bad:  "The new workflow improved efficiency significantly and the team is much happier."
Good: "Restructuring lead nurturing (context) drove a 43% conversion lift (achievement),
       generating €1.2M in additional annual revenue (relevance)."

Bad:  "We helped them process invoices faster."
Good: "Cut invoice-processing time from 6 days to 4 hours (−97%) within the first quarter."

A result that lacks a baseline or a timeframe is not a result — it is an unfalsifiable claim. Always pair before with after, and always state the window.

Testimonial / quote craft

The quote is the conversion lever, so make it carry weight. Specific beats glowing. One claim per quote — a quote that says three things says nothing.

text
Bad:  "Great product, the team is amazing, highly recommend! — a happy customer"
Good: "We cut new-hire onboarding from 3 weeks to 2 days — my team stopped dreading
       every new starter. — Ana Pérez, COO, Acme Logistics"

Rules:

  • Named + title + company. Attribution is what makes it believable. Anonymous quotes read as invented.
  • Same industry wins. A quote from the prospect's own sector lifts lead quality; match where you can.
  • One concrete claim. Tie the quote to a number or a felt change, not to adjectives.
  • The customer's voice, not yours. If it sounds like your marketing, the buyer discounts it. Approve any edit with the customer.

Format leverage — write once, cut many

Default to a repurposable structure, because video is now the top-rated B2B content format (58% rate it most effective, with case studies/customer stories close behind at 53% — CMI/MarketingProfs 2025 Benchmarks, Oct 2024) and testimonials are a measured conversion lever, not decoration: a three-line testimonial block lifted landing-page conversion 34% in VWO's WikiJob A/B test, and Unbounce reported swapping static reviews for video testimonials lifted conversion up to 80%. From one signed-off case study you should be able to cut, with no new approval needed:

  • a pull-stat card (the headline KPI on its own),
  • a quote card (the attributed testimonial),
  • a 30–60s video script (challenge in one line, result in one line, the quote read aloud).

Write the prose so these fall out cleanly; do not produce a separate brochure for each. (This is the cut, not a full video-production guide — that craft lives elsewhere.)

Anti-patterns

BadGood
Hero headline is the customer's company nameHero is the result + a number ("Churn cut 40% in one quarter")
"Increased revenue" with no baseline or windowbaseline → result → timeframe, every time
Publish the quote before the customer signs offExact-quote written approval first, retained
Anonymous "— a satisfied client"Named + title + company, or anonymize the whole story honestly
Superlatives: "revolutionary", "seamless", "best-in-class"Verifiable specifics with units
Insider/employee quote presented as a customerClear material-connection disclosure, or drop it
Vendor-praise narrative ("we are proud to...")Buyer-serving proof ("here is what changed for them")
One 2,500-word wall of prose600–1,200 words, snapshot box up top, scannable
A metric you cannot sourceOnly published numbers you can substantiate on demand

Verify + handoffs

scripts/verify.sh <case-study.md> is a read-only structural and legal lint. It checks for a quantified hero metric, the required Challenge/Solution/Result sections and snapshot box, an attributed quote, a before→after signal, a CTA, and the consent: / approved: marker — and it warns on the superlative banlist. It fails hard when the hero has no metric, a core section is missing, or consent is unmarked, because shipping an un-consented named quote is the legal risk. It is structural lint only; persuasion quality is the capability eval's job and yours.

Hand off when the piece is done: the proven quote → ../landing-copy/SKILL.md, the broader narrative → ../article-writing/SKILL.md, the slide version → ../pitch-deck/SKILL.md, the public-review angle → ../review-management/SKILL.md.

© ericrisco, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (scripts, references) in skills/case-studies of ericrisco/rsc-harness.

  • SKILL.md
  • evals/README.md
  • evals/cases.yaml
  • references/case-study-skeleton.md
  • references/consent-and-substantiation.md
  • scripts/verify.sh

Open the folder on GitHubat commit 92fde8f

Compare with similar skills

Case Studies next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Case Studies compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Case Studies this skillericrisco/rsc-harness156—~2.8kAutomated safety check: PassMIT
Eight-Part Company Deep DiveHKUDS/Vibe-Trading35k—~2.4kAutomated safety check: PassMIT
Reading Guidechingswy/Skill-Research-Figure178—~4.5kAutomated safety check: PassNone
Aboutsecurity Content Ingestionwgpsec/AboutSecurity1.8k—~1.4kAutomated safety check: PassNone
Vc Curated MatchVarnan-Tech/opendirectory672—~378Automated safety check: PassMIT
Khazix WeChat Article WriterKKKKhazix/khazix-skills21k2 repos~2.9kAutomated safety check: PassMIT

Similar skills

  • Plans and drafts an eight-part, roughly 120k-word investigative series on one company, built around a strict fact-check pass rather than fast drafting.

    35k GitHub stars~2.4k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Reading Guide

    chingswy/Skill-Research-Figure

    Structured learning navigator for blog posts and articles. An agent skill from chingswy/Skill-Research-Figure.

    178 GitHub stars~4.5k tokensUpdated 26 days ago
    Writing & ContentAuto-check passed
  • A skill your agent uses whenever the user asks to add, absorb, migrate, port, update, merge, compare, or extract security knowledge into the AboutSecurity repository from any external resource such…

    1.8k GitHub stars~1.4k tokensUpdated 4 days ago
    Writing & ContentAuto-check passed
  • Vc Curated Match

    Varnan-Tech/opendirectory

    Accepts a product description and URL to algorithmically identify relevant Venture Capital investors targeting exactly that stage, industry, and niche based on a curated static dataset.

    672 GitHub stars~378 tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed
  • Khazix WeChat Article Writer

    KKKKhazix/khazix-skills

    Writes long-form WeChat official account articles in the personal style of the Khazix account, from briefs, links, PDFs or rough notes, with a topic quality check.

    21k GitHub starsUsed in 2 repos~2.9k tokens
    Writing & ContentAuto-check passed
  • Figure

    vectorize-io/hindsight

    Draw an animated figure (boxes, arrows, moving data) as one self-contained SVG for a GitHub README, PR, issue or blog post.

    46k GitHub stars~1.9k tokensUpdated today
    Writing & ContentAuto-check passed

More from ericrisco/rsc-harness

All 229 skills in this repo
  • Ab Testing

    ericrisco/rsc-harness

    A skill your agent uses when designing or analyzing a controlled experiment — falsifiable hypothesis, sample size from an MDE, reading significance/CI/power, CUPED, or rescuing tests that won't go…

    156 GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Accessibility

    ericrisco/rsc-harness

    A skill your agent uses when making a web UI conform to WCAG 2.2 Level AA — axe-core or Lighthouse a11y violations, keyboard operability, focus management, ARIA roles/names/live regions, contrast…

    156 GitHub stars~3.4k tokensUpdated today
    Auto-check passed
  • Ads

    ericrisco/rsc-harness

    A skill your agent uses when running or fixing paid acquisition on Google or Meta — campaign structure (Performance Max, Demand Gen, Search, Advantage+), platform-fit creative, budget/scaling rules…

    156 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Agent Eval

    ericrisco/rsc-harness

    A skill your agent uses when measuring whether an LLM or agent system actually got better and gating merges on it: golden sets, fixing an inflated LLM-as-judge, scoring RAG (faithfulness, contextual…

    156 GitHub stars~3.2k tokensUpdated today
    Auto-check passed
  • AI Media

    ericrisco/rsc-harness

    A skill your agent uses when a creative goal must become a finished media file: pick and order generative-media models per modality — AI voiceover, image-to-video clips, score — then glue them with…

    156 GitHub stars~3.3k tokensUpdated today
    Auto-check passed
  • Analytics

    ericrisco/rsc-harness

    A skill your agent uses when instrumenting product or web analytics — GA4/PostHog SDK wiring, event taxonomy, funnels, double-counted events, consent gating, PII scrubbing.

    156 GitHub stars~2.8k tokensUpdated today
    Auto-check passed

Questions about Case Studies

What does Case Studies do?

A skill your agent uses when turning one named customer's measured win into a case study, or the attributed testimonial quote that travels with it — consent-cleared, metrics-anchored proof for the…. Case Studies is an agent skill from ericrisco/rsc-harness. Use when turning one named customer's measured win into a case study, or the attributed testimonial quote that travels with it — consent-cleared, metrics-anchored proof for the next skeptical buyer.

When should I use Case Studies?

Case Studies fits situations like: turning one named customers measured win into a case study; the attributed testimonial quote that travels with it — consent-cleared; metrics-anchored proof for the next skeptical buyer.

How do I install Case Studies in Claude Code?

Run `npx skills add ericrisco/rsc-harness --skill case-studies -a claude-code`. Or copy the skill folder (skills/case-studies in ericrisco/rsc-harness) into .claude/skills/case-studies in your project. Claude Code loads it when a task matches its description.

How do I install Case Studies in Codex?

Run `npx skills add ericrisco/rsc-harness --skill case-studies -a codex`. Or copy the skill folder (skills/case-studies in ericrisco/rsc-harness) into .agents/skills/case-studies in your project. Codex loads it when a task matches its description.

Can I use Case Studies in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ericrisco/rsc-harness --skill case-studies -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/case-studies, .gemini/skills/case-studies, .github/skills/case-studies and .opencode/skills/case-studies in your project.

What does Case Studies need to run?

Going by SKILL.md and its folder, Case Studies needs a shell for the scripts in its folder. Our summary lists: A Bash shell.

Does Case Studies access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Case Studies safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Case Studies use?

Case Studies is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Case Studies use?

About 2.8k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.9k tokens, read only when the agent opens those files.

What are the alternatives to Case Studies?

Skills that share tags, products or a category with Case Studies: Eight-Part Company Deep Dive (HKUDS/Vibe-Trading, 35k stars), Reading Guide (chingswy/Skill-Research-Figure, 178 stars), Aboutsecurity Content Ingestion (wgpsec/AboutSecurity, 1.8k stars) and Vc Curated Match (Varnan-Tech/opendirectory, 672 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Case Studies?

ericrisco (a GitHub user) maintains it in ericrisco/rsc-harness, which has 156 GitHub stars. The repository holds 229 skills in this directory. The repository was last updated on October 6, 2026.

Source: ericrisco/rsc-harness on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.