Pages: Customer Stories
Guides customer story and case study page content, structure, and conversion.
When invoking: On first use, if helpful, open with 1-2 sentences on what this skill covers and why it matters, then provide the main output. On subsequent use or when the user asks to skip, go directly to the main output.
Initial Assessment
Check for project context first: If .claude/project-context.md or .cursor/project-context.md exists, read it for product, proof points, and customer language.
Identify:
- Story format: Full case study, quote snippet, video
- Industries/use cases: Who to showcase
- Metrics: What results to highlight
Best Practices
Structure (Challenge -> Solution -> Results)
| Section |
Content |
| Headline |
Benefit-driven; lead with outcome |
| Challenge |
Client's problem, pain points |
| Solution |
How your product helped |
| Results |
Quantifiable metrics, before/after |
| Quote |
Direct testimonial from client |
| CTA |
Next step (demo, contact, read more) |
Content Principles
- Lead with results: Outcomes first, not background
- Specific metrics: "Increased revenue 40%" not "great results"
- Quotes: Direct, attributed, credible
- Scannable: Consistent template; easy to skim
- Concise: Enough value without losing interest
Visual Elements
- Logos: Client branding (with permission)
- Charts/graphs: Before-after, metrics
- Video: Testimonials, interviews
- Expandable sections: For deeper detail
Why It Matters
- 54% of buyers review case studies before purchasing
- 73% of successful content marketers use them
- Builds credibility, justifies pricing, shortens sales cycles
Storytelling
- Problem = beginning
- Solution = climax
- Results = resolution
- Hard facts: Statistics for impact
Output Format
- Template structure
- Story outline (challenge, solution, results)
- Metrics to capture
- SEO metadata and schema (if indexing)
- Internal linking to product/pricing
Related Skills
- landing-page-generator: Case studies and testimonials for LP social proof (step 2)
- url-slug-generator: URL slug for case study pages (e.g. /customers/case-slug); 3-5 words
- about-page-generator: Social proof complements About
- pricing-page-generator: Case studies support pricing justification
- homepage-generator: Customer stories on homepage
- schema-markup: CaseStudy schema
1---2name: customer-stories-page-generator3description: When the user wants to create, optimize, or audit customer stories or case study pages. Also use when the user mentions "case studies," "customer stories," "success stories," "testimonials page," "case study," "customer proof," "social proof page," or "results page." For testimonial components, use testimonials-generator.4---5
6# Pages: Customer Stories
7
8Guides customer story and case study page content, structure, and conversion.
9
10**When invoking**: On **first use**, if helpful, open with 1-2 sentences on what this skill covers and why it matters, then provide the main output. On **subsequent use** or when the user asks to skip, go directly to the main output.
11
12## Initial Assessment
13
14**Check for project context first:** If `.claude/project-context.md` or `.cursor/project-context.md` exists, read it for product, proof points, and customer language.
15
16Identify:
171. **Story format**: Full case study, quote snippet, video
182. **Industries/use cases**: Who to showcase
193. **Metrics**: What results to highlight
20
21## Best Practices
22
23### Structure (Challenge -> Solution -> Results)
24
25| Section | Content |
26|---------|---------|
27| **Headline** | Benefit-driven; lead with outcome |
28| **Challenge** | Client's problem, pain points |
29| **Solution** | How your product helped |
30| **Results** | Quantifiable metrics, before/after |
31| **Quote** | Direct testimonial from client |
32| **CTA** | Next step (demo, contact, read more) |
33
34### Content Principles
35
36- **Lead with results**: Outcomes first, not background
37- **Specific metrics**: "Increased revenue 40%" not "great results"
38- **Quotes**: Direct, attributed, credible
39- **Scannable**: Consistent template; easy to skim
40- **Concise**: Enough value without losing interest
41
42### Visual Elements
43
44- **Logos**: Client branding (with permission)
45- **Charts/graphs**: Before-after, metrics
46- **Video**: Testimonials, interviews
47- **Expandable sections**: For deeper detail
48
49### Why It Matters
50
51- 54% of buyers review case studies before purchasing
52- 73% of successful content marketers use them
53- Builds credibility, justifies pricing, shortens sales cycles
54
55### Storytelling
56
57- **Problem** = beginning
58- **Solution** = climax
59- **Results** = resolution
60- **Hard facts**: Statistics for impact
61
62## Output Format
63
64- **Template** structure
65- **Story** outline (challenge, solution, results)
66- **Metrics** to capture
67- **SEO** metadata and schema (if indexing)
68- **Internal linking** to product/pricing
69
70## Related Skills
71
72- **landing-page-generator**: Case studies and testimonials for LP social proof (step 2)
73- **url-slug-generator**: URL slug for case study pages (e.g. /customers/case-slug); 3-5 words
74- **about-page-generator**: Social proof complements About
75- **pricing-page-generator**: Case studies support pricing justification
76- **homepage-generator**: Customer stories on homepage
77- **schema-markup**: CaseStudy schema
gabrielmoreira