AgentSkillsCN

faq-generator

当用户希望为其网站创建 FAQ 页面、FAQ 专区,或结构化的问答内容时使用。同样适用于用户提及“FAQ”、“常见问题”、“问答专区”、“知识库”、“帮助中心内容”或“解答问题”等场景。该技能可生成经过 SEO 优化的 FAQ 内容,并配备 Schema 标记,既适用于传统搜索引擎,也适配 AI 答案引擎。

SKILL.md
--- frontmatter
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:

json
{
  "@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