customer-story-builder
Take raw customer inputs — interview transcripts, survey responses, Slack quotes, support tickets, review excerpts — and generate a structured case study draft with problem/solution/result narrative, pull-quotes, metric callouts, and multi-format outputs (full case study, one-pager, social proof snippet, sales deck slide). Pure reasoning skill. Use when a product marketing team has customer signal but no time to write the story.
Best use case
customer-story-builder is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Take raw customer inputs — interview transcripts, survey responses, Slack quotes, support tickets, review excerpts — and generate a structured case study draft with problem/solution/result narrative, pull-quotes, metric callouts, and multi-format outputs (full case study, one-pager, social proof snippet, sales deck slide). Pure reasoning skill. Use when a product marketing team has customer signal but no time to write the story.
Teams using customer-story-builder should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/customer-story-builder/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How customer-story-builder Compares
| Feature / Agent | customer-story-builder | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Take raw customer inputs — interview transcripts, survey responses, Slack quotes, support tickets, review excerpts — and generate a structured case study draft with problem/solution/result narrative, pull-quotes, metric callouts, and multi-format outputs (full case study, one-pager, social proof snippet, sales deck slide). Pure reasoning skill. Use when a product marketing team has customer signal but no time to write the story.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
AI Agent for Product Research
Browse AI agent skills for product research, competitive analysis, customer discovery, and structured product decision support.
AI Agent for SaaS Idea Validation
Use AI agent skills for SaaS idea validation, market research, customer discovery, competitor analysis, and documenting startup hypotheses.
AI Agents for Startups
Explore AI agent skills for startup validation, product research, growth experiments, documentation, and fast execution with small teams.
SKILL.md Source
# Customer Story Builder
Turn raw customer signal into a polished case study — plus every derivative format you need. One input (messy transcript or quote), all outputs (case study, one-pager, social snippet, deck slide).
**Core principle:** The best customer stories already exist in your support tickets, Slack channels, and call recordings. You just need to extract and structure them.
## When to Use
- "Turn this customer interview into a case study"
- "We have a great Slack quote from [customer] — help me build a story around it"
- "Write a case study for [customer]"
- "I need social proof assets from [customer win]"
- "Package this customer result for the sales team"
## Phase 0: Intake
### Customer Context
1. **Customer name** — Can we use their name publicly? (Named vs. anonymous)
2. **Company description** — Industry, size, stage (1 sentence)
3. **Customer role/title** — Who's the champion?
4. **How long have they been a customer?**
### Raw Input (provide any/all)
5. **Interview transcript** — Full or partial transcript from a customer call
6. **Slack/email quotes** — Specific messages where they praised the product
7. **Survey responses** — NPS comments, CSAT feedback
8. **Support ticket excerpts** — Before/after of a problem solved
9. **Review excerpts** — G2, Capterra, Trustpilot quotes
10. **Metrics** — Any numbers: time saved, revenue impact, efficiency gains, before/after
### Story Angle
11. **Primary use case** — What were they using the product for?
12. **Key transformation** — What changed? (The "before → after" in one sentence)
13. **Output formats needed** — Full case study, one-pager, social snippet, sales slide, or all?
## Phase 1: Extract Story Elements
From the raw inputs, identify and extract:
### The Problem (Before)
- What was the customer's situation before using the product?
- What specific pain were they experiencing?
- What had they tried before? (Manual process, competitor, nothing)
- How bad was it? (Quantify if possible — hours wasted, money lost, deals missed)
### The Decision (Why You)
- Why did they choose your product?
- What alternatives did they consider?
- What was the deciding factor?
### The Solution (How)
- Which specific features/capabilities did they use?
- How did they implement it? (Timeline, effort)
- Any surprising use cases or creative applications?
### The Result (After)
- **Hard metrics** — numbers, percentages, time saved, revenue gained
- **Soft outcomes** — confidence, team morale, process improvements
- **Before/after comparison** — the transformation in concrete terms
### Best Quotes
Pull the 3-5 strongest verbatim quotes from the raw input:
- **Hero quote** — the single most powerful statement (for headlines)
- **Problem quote** — describes the pain vividly
- **Result quote** — describes the outcome with specificity
- **Recommendation quote** — would they recommend? Why?
## Phase 2: Generate Story Outputs
### Output 1: Full Case Study (800-1200 words)
```markdown
# [Headline: Outcome-driven, not product-driven]
*[Subhead: Customer name + one-line result]*
---
## About [Customer]
[2-3 sentences: company, industry, size, what they do]
## The Challenge
[2-3 paragraphs: What was the problem? Why did it matter? What had they tried?]
> "[Problem quote]"
> — [Name], [Title] at [Company]
## Why [Your Product]
[1-2 paragraphs: How did they find you? What made them choose you?]
## The Solution
[2-3 paragraphs: How did they use the product? Which capabilities mattered most?]
> "[Solution/experience quote]"
## The Results
[Results summary with metric callouts]
### Key Metrics
- **[Metric 1]:** [Number + context]
- **[Metric 2]:** [Number + context]
- **[Metric 3]:** [Number + context]
> "[Result quote]"
## What's Next
[1 paragraph: Future plans, expansion, what they're excited about]
---
**Industry:** [X] | **Company size:** [X] | **Use case:** [X] | **Product:** [X]
```
### Output 2: One-Pager (Sales Leave-Behind)
```markdown
# [Customer Name]: [Headline Result]
**Challenge:** [2 sentences]
**Solution:** [2 sentences — what they use and how]
**Results:**
- [Metric 1]
- [Metric 2]
- [Metric 3]
> "[Hero quote]"
> — [Name], [Title]
[CTA: Learn more / Request a demo]
```
### Output 3: Social Proof Snippets
**For website testimonial section:**
```
"[Short, punchy quote — max 2 sentences]"
— [Name], [Title] at [Company]
[Result: X% improvement in Y]
```
**For LinkedIn post:**
```
[Customer Name] just shared their results:
→ [Metric 1]
→ [Metric 2]
→ [Metric 3]
"[Quote]"
Here's their story: [link]
```
**For cold email insert:**
```
[Company in their industry] saw [key metric] after switching to [Product].
"[Short quote about the result]" — [Name], [Title]
```
### Output 4: Sales Deck Slide Content
```
Slide title: "[Customer] — [Key Result]"
Left side:
- Challenge: [1 line]
- Solution: [1 line]
- Result: [1 line with metric]
Right side:
> "[Hero quote]"
— [Name], [Title]
[Customer logo]
```
### Output 5: Metric Callout Cards
For website or marketing collateral:
```
[BIG NUMBER]
[Label — e.g., "hours saved per week"]
— [Customer Name]
```
Generate 2-3 of these from the strongest metrics.
## Phase 3: Story Quality Check
Before finalizing, verify:
- [ ] **Specificity** — Are results concrete, not vague? ("3x pipeline" > "improved results")
- [ ] **Credibility** — Is the customer named? Is the metric believable?
- [ ] **Relevance** — Does this story match your ICP? Will prospects see themselves?
- [ ] **Permission** — Flag if customer approval is needed before publishing
- [ ] **Freshness** — Are the results recent? (>12 months old = less impactful)
## Phase 4: Output
Save all assets to `clients/<client-name>/product-marketing/customer-stories/[customer-slug]/`:
- `case-study-full.md` — Complete case study
- `one-pager.md` — Sales leave-behind
- `social-snippets.md` — All social proof formats
- `slide-content.md` — Deck slide content
- `raw-inputs.md` — Original source material (for reference)
## Cost
| Component | Cost |
|-----------|------|
| All story generation | Free (LLM reasoning) |
| **Total** | **Free** |
## Tools Required
None. Pure reasoning skill. Takes raw text input and produces structured outputs.
## Trigger Phrases
- "Turn this transcript into a case study"
- "Build a customer story for [customer]"
- "Package [customer]'s results as social proof"
- "Run customer story builder for [customer]"Related Skills
qbr-deck-builder
Pull customer usage highlights, support history, feature adoption, NPS/CSAT data, and ROI metrics into a structured QBR deck outline with slide-by-slide content. Outputs markdown slide content ready for HTML slides or Google Slides. Designed for CS teams at seed/Series A who run QBRs but don't have time to build decks from scratch.
icp-persona-builder
Research a company's ideal customer profiles and build detailed synthetic personas. Identifies 4-6 distinct buyer segments through web research, then creates rich, realistic personas with demographics, motivations, skepticism profiles, decision criteria, and language patterns. Saves personas as a reusable client asset that other skills can reference.
demo-builder
Builds personalized demo assets for top prospects using the founder's product API/MCP/SDK. Researches prospect, proposes demo concepts, builds working prototype, tests it, and generates comparison report with live demo link.
voice-of-customer-synthesizer
Aggregate customer feedback from multiple sources — support tickets, NPS comments, Slack messages, G2 reviews, call transcripts, survey responses — into a unified VoC report with theme clustering, sentiment analysis, trend detection, and actionable recommendations for product, marketing, and CS teams. Chains review-site-scraper for public review data.
meta-ads-campaign-builder
End-to-end Meta Ads campaign builder for Facebook and Instagram. Takes ICP + objective, generates audience targeting recommendations, ad set structure, copy framework per placement, and exports as a campaign brief or structured CSV. Focused on campaign architecture, not creative generation.
launch-positioning-builder
Research competitors, analyze their messaging, and generate a positioning document with category definition, differentiation claims, value propositions, and proof points. Chains web research, competitor site analysis, and review mining to produce a positioning doc ready for website copy and sales deck use. Use when a product marketing team needs to define or refresh positioning ahead of a launch, rebrand, or competitive shift.
google-search-ads-builder
End-to-end Google Search Ads campaign builder. Performs deep keyword research (competitor SEO, review language mining, Reddit/HN community terminology, site audit), builds keyword architecture with funnel mapping and intent classification, creates ad group structure, generates headline/description variants, builds negative keyword lists, recommends bid strategy, and exports a campaign-ready CSV for Google Ads Editor import.
customer-win-back-sequencer
For churned accounts, research what has changed since they left — new funding, team growth, competitor dissatisfaction, product updates that address their pain — then assess re-engagement potential and generate a personalized win-back email sequence with timing recommendations. Chains web research and LinkedIn monitoring with email sequence generation.
tam-builder
Build and maintain a scored Total Addressable Market (TAM) using Apollo Company Search. Discovers companies matching ICP, scores fit (0-100), assigns tiers (1/2/3), and auto-builds a persona watchlist for Tier 1-2 companies using Apollo People Search (free). Outputs to CSV.
customer-discovery
Discover all customers of a given company by scanning websites, case studies, review sites, press, social media, job postings, and more. Use when you need competitive intelligence on who a company sells to.
competitor-monitoring-system
Set up and run ongoing competitive intelligence monitoring for a client. Tracks competitor content, ads, reviews, social, and product moves.
client-packet-engine
Batch client packet generator. Takes company names/URLs, runs intelligence + strategy generation, presents strategies for human selection, executes selected strategies in pitch-packet mode (no live campaigns or paid enrichment), and packages into local delivery packets.