🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί faq-page-generator
πŸ¦€ ClawHub

faq-page-generator

by @kostja94

When the user wants to create, optimize, or audit FAQ page content. Also use when the user mentions "FAQ page," "frequently asked questions," "help page," "Q...

Versionv1.2.0
#clawhub
πŸ“‹ Tips & Best Practices

Word Count

| Element | Range | Notes | |---------|-------|------| | Answer | 40-80 words | Sweet spot for AI; under 40 = incomplete; over 80 = cut off | | Featured Snippet | 40-60 words | 45 words most common | | First sentence | 40-50 words | Answer immediately | | Sentences | 2-4 | Standalone, comprehensive |

Content Rules

  • Genuine questions: PAA, AnswerThePublic, support; no invented marketing questions
  • Standalone answers: Each answer makes sense alone; AI extracts individual pairs
  • Content parity: Schema must exactly match visible content; hidden schema = violation
  • No duplicates: Each Q&A on one page; choose most authoritative
  • Topical focus: FAQs match page topic
  • Inverted pyramid: Most important first; data, numbers, actionable advice
  • Keywords: 1-2 times naturally; no stuffing
  • Quality over quantity: 5-10 excellent beat 50 thin
  • Update quarterly: Add questions from emerging trends

    • Format

  • Schema: JSON-LD; one FAQPage per page
  • Answer HTML (in schema text): , , ,

    ,
    ,

      ; use sparingly
    1. Structure: H2/H3 per question; semantic HTML; answer-first under heading
    2. Validation: Google Rich Results Test, Schema.org Validator, GSC

      3. Number of Questions

      | Placement | Count | Notes | |-----------|-------|------| | In-page section | 3-8 | Directly related to page | | Dedicated page | 5-10 optimal | 10-30 if well-crafted; quality over quantity | | Schema minimum | 2+ | Single Q&A rarely shown | | Google display | Max 2 per result | See serp-features |

      Question and Answer

      Question: Match how users ask ("How do I return?" not "Return Policy"); target "how/what/why"; H2/H3; avoid promotional or invented.

      Answer: Answer-first in 40-60 words; paragraph, list, or table by content type; scannable (bullets, bold); self-contained; entity signals. See entity-seo.

      Organization

      Group by topic; clear hierarchy; TOC, accordions, jump links; audit quarterly.

    • View on ClawHub
    TERMINAL
    clawhub install faq-page-generator

    πŸ§ͺ Use this skill with your agent

    Most visitors already have an agent. Pick your environment, install or copy the workflow, then run the smoke-test prompt above.

    Manus
    Task-oriented agent. Great for testing AI skills end-to-end.
    Try Manus β†’
    OpenClaw
    Local-first agent. Install skills via ClawHub CLI.
    Set up OpenClaw β†’
    Claude Code
    Anthropic's coding agent. Paste the prompt or SKILL.md into your session.
    Claude Code docs β†’
    Cursor
    AI-powered IDE. Use the smoke-test prompt in Cursor Agent.
    Open Cursor β†’
    Continue.dev
    Open-source AI code assistant. Add SKILL.md as a custom tool.
    Continue docs β†’
    Windsurf
    Agentic IDE by Codeium. Paste the prompt into Cascade.
    Try Windsurf β†’
    Cline
    VS Code extension for autonomous coding with MCP tools.
    Cline on GitHub β†’
    Copilot Workspace
    GitHub's AI dev environment. Suitable for code-generation skills.
    Copilot Workspace β†’

    πŸ” Can't find the right skill?

    Search 60,000+ AI agent skills β€” free, no login needed.

    Search Skills β†’