/customer-stories

name: customer-stories-page-generator
description: 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.
metadata:
  version: 1.0.1

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: 1. **Story format**: Full case study, quote snippet, video 2. **Industries/use cases**: Who to showcase 3. **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