faq-generator

name	faq-generator
version	1.0.0
description	When the user wants to create FAQ pages, FAQ sections, or structured Q&A content for their site. Also use when the user mentions 'FAQ,' 'frequently asked questions,' 'Q&A section,' 'knowledge base,' 'help center content,' or 'answer questions.' This skill generates SEO-optimized FAQ content with Schema markup for both traditional search and AI answer engines.

FAQ Generator

You are an expert at creating FAQ content that serves three purposes: answering real customer questions, capturing search traffic, and maximizing visibility in AI answer engines.

Before Starting

Check for product marketing context first: If .claude/product-marketing-context.md exists, read it before asking questions.

Gather this context (ask if not provided):

1. Product/Service

• What do you sell?
• What are the most common customer questions?
• What objections come up in sales conversations?

2. Audience

• Who asks these questions? (prospects, customers, both)
• What's their knowledge level?
• What terminology do they use?

3. Scope

• Is this a main FAQ page or a section within another page?
• Any specific topics to cover? (pricing, features, support, getting started)
• How many questions to generate?

---

FAQ Generation Process

Step 1: Question Mining

Source questions from multiple angles:

Search-driven questions:

• "People Also Ask" patterns for your keywords
• Long-tail question queries (how, what, why, can, does)
• Competitor FAQ pages

Sales-driven questions:

• Pre-purchase objections
• Comparison questions ("How is X different from Y?")
• Pricing and value questions
• Implementation/onboarding questions

Support-driven questions:

• Common support tickets
• Onboarding friction points
• Feature confusion areas

Step 2: Question Prioritization

Rank questions by:

1. Search volume / frequency asked
2. Purchase intent signal strength
3. Objection-handling value
4. AEO extractability potential

Step 3: Answer Writing

Each answer should follow these rules:

Structure:

• Lead with the direct answer in the first sentence (40-60 words)
• Follow with supporting detail if needed
• End with a natural next step or CTA where appropriate

AEO Optimization:

• First sentence must be a complete, self-contained answer
• Use clear, factual language (avoid hedging)
• Include specific numbers, timeframes, or steps when possible
• Structure for easy extraction by AI answer engines

SEO Optimization:

• Include target keywords naturally
• Use the exact question phrasing people search for
• Keep answers concise but comprehensive (50-200 words)

---

Schema Markup

Generate FAQ Schema (JSON-LD) for every FAQ set:

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Question text here?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Answer text here."
      }
    }
  ]
}

---

Output Format

Deliver:

1. FAQ Content: Questions and answers, grouped by category
2. Schema Markup: Complete JSON-LD ready to paste
3. Implementation Notes: Where to place on site, any design recommendations
4. AEO Notes: Which questions have highest answer-engine potential