Faq SEO skill
Builds question-driven FAQ content that wins featured snippets and People Also Ask placements: question research, answer formatting, FAQ schema, and page placement.
by LeadMagic·MIT license·★ 62 Stars on the repo·GitHub ↗
npx degit LeadMagic/gtm-skills/skills/content-seo/faq-seo#main ~/.claude/skills/faq-seoChecked ·commit main
Inside this skill
SKILL.md · the author's own words# FAQ SEO ## Overview FAQ content captures featured snippets (position zero), People Also Ask boxes, and voice search results. These are the highest-visibility SERP features — and they're often the lowest-competition ranking opportunities. This skill covers question-driven content strategy. ## Authoritative Foundations - **Google Search Central — SEO Starter Guide** — Google's foundational SEO resource with structured data documentation, FAQ schema guidance, and content quality standards. - **Schema.org FAQPage Specification** — Structured data standard enabling rich results and AI engine parsing of question-and-answer content. - **Ahrefs — People Also Ask Mining** — Research methodology for identifying and
Word-for-word excerpt, not a result. Read the full SKILL.md ↓
Files of Faq SEO
Show the full text165 lines
FAQ SEO
Overview
FAQ content captures featured snippets (position zero), People Also Ask boxes, and voice search results. These are the highest-visibility SERP features — and they're often the lowest-competition ranking opportunities. This skill covers question-driven content strategy.
Authoritative Foundations
- Google Search Central — SEO Starter Guide — Google's foundational SEO resource with structured data documentation, FAQ schema guidance, and content quality standards.
- Schema.org FAQPage Specification — Structured data standard enabling rich results and AI engine parsing of question-and-answer content.
- Ahrefs — People Also Ask Mining — Research methodology for identifying and prioritizing question-based content from search engine PAA boxes.
When to Use
- "Build FAQ content"
- "Target featured snippets"
- "People Also Ask strategy"
- "Question-based SEO"
- "Voice search optimization"
Step-by-Step Process
Phase 1: Question Mining
Find the questions your ICP is asking:
- Google People Also Ask: Search your core keywords. Mine the PAA boxes. Expand each question for more PAA questions. Repeat 3-4 levels deep.
- Google Autocomplete: Type your keyword + "how", "what", "why", "when", "where", "can", "do", "is" — capture all suggestions.
- AnswerThePublic / AlsoAsked.com: Automated question mining tools
- Reddit: Search your topic in relevant subreddits. Sort by top posts. Look for questions in post titles and comments.
- Quora: Search your topic. Sort by most followed questions.
- Customer conversations: Sales calls, support tickets, onboarding questions. These are the questions with real business intent behind them.
- Competitor FAQ pages: What questions are they answering? What are they missing that you can own?
Phase 2: Question Prioritization
Score each question on:
- Search volume: 50+ monthly searches preferred
- Business relevance: Does answering this lead to your product?
- Featured snippet opportunity: Does the current snippet suck? (Short answer, no source, from a weak site)
- Competition: Can you outrank the current #1? Check domain rating of the page currently ranking.
Phase 3: FAQ Content Structure
For each question, create a dedicated section:
Format for featured snippets:
- Question as H2 or H3: Exact or near-exact match to the query
- Answer in 40-60 words: Clear, definitive, authoritative. Start with the answer, then elaborate. This is what Google pulls for the snippet.
- Elaboration: 100-300 words expanding on the answer with examples, data, or context
- Related links: Link to deeper content on the topic
FAQ page structure:
- Group questions by topic (H2 per topic group)
- 10-20 questions per page
- FAQ schema markup on every question-answer pair
- Table of contents at the top (jump links to each question)
- CTA after the most business-relevant question
Phase 4: Schema Implementation
Implement FAQ schema on every question page:
{
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "What is email verification?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Email verification is the process of..."
}
}
]
}
Since August 2023, Google shows FAQ rich results only for well-known government and health sites, so do not promise expandable FAQ listings. The markup still helps search and AI engines parse each question-answer pair.
Phase 5: Measurement
- Featured snippet wins: Track which questions you own the snippet for
- PAA appearances: Track which questions you appear in the PAA box
- FAQ traffic: Organic traffic to FAQ pages
- FAQ-to-conversion: How many FAQ visitors go on to product pages, sign up, or request demos
- Voice search: Track voice search queries (available in Search Console with some filtering)
Output Format
FAQ strategy document with: question inventory, prioritization matrix, content template, schema implementation, and measurement dashboard.
Quality Check
Before delivering, verify:
- All required sections are complete
- Output matches the user's stated need
- Named frameworks are cited for key recommendations
- No vague claims — every recommendation has a specific action
- Deliverable is ready for operational use, not just conceptual
Common Pitfalls
- Writing for search engines, not humans. Keyword-stuffed content that reads like a robot wrote it. Fix: write for your ICP first, optimize for search second.
- Publishing and praying. Creating content without a distribution plan. Fix: every piece gets a 30-day promotion calendar across email, social, and paid.
- Ignoring content freshness. 2-year-old content with outdated data and examples still ranking. Fix: quarterly content audit — update or retire stale pieces.
Execution Artifacts
references/framework-notes.md— PAA/snippet format, FAQ schema, AEO overlap, Pattern 25 routingtemplates/output-template.md— Deliverable shell for agent outputscripts/check-output.py— Lightweight deliverable validatorreferences/seo-strategy-playbook.md— Repo root: §4 schema, §8 AEO overlap- the
using-gtm-skillsskill — Pattern 25: B2B SEO Stack (step 4)
Related Skills
- seo-strategy, aeo-strategy, pillar-pages, content-marketing, landing-pages
| 1 | |
| 2 | name faq-seo |
| 3 | description >- |
| 4 | Builds question-driven FAQ content that wins featured snippets and People Also |
| 5 | Ask placements: question research, answer formatting, FAQ schema, and page |
| 6 | placement. Use when the user wants to target featured snippets, PAA boxes, or |
| 7 | voice search, or needs an FAQ page that ranks. Triggers on: "FAQ SEO", |
| 8 | "featured snippet", "People Also Ask", "question SEO", "answer content". |
| 9 | license MIT |
| 10 | compatibility Claude Code, Codex, GitHub Copilot, Cursor, Gemini CLI, OpenCode, Goose, Hermes, Windsurf, Zed |
| 11 | metadata |
| 12 | version "1.0.0" |
| 13 | author LeadMagic |
| 14 | category content-seo |
| 15 | tags [content-seo, faq, featured-snippets, people-also-ask, questions] |
| 16 | frameworks |
| 17 | - "Google Search Central — SEO Starter Guide" |
| 18 | - "Schema.org FAQPage Specification" |
| 19 | - "Ahrefs — People Also Ask Mining" |
| 20 | |
| 21 | |
| 22 | # FAQ SEO |
| 23 | |
| 24 | ## Overview |
| 25 | |
| 26 | FAQ content captures featured snippets (position zero), People Also Ask boxes, |
| 27 | and voice search results. These are the highest-visibility SERP features — |
| 28 | and they're often the lowest-competition ranking opportunities. This skill |
| 29 | covers question-driven content strategy. |
| 30 | |
| 31 | ## Authoritative Foundations |
| 32 | |
| 33 | **Google Search Central — SEO Starter Guide** — Google's foundational SEO resource with |
| 34 | structured data documentation, FAQ schema guidance, and content quality standards. |
| 35 | **Schema.org FAQPage Specification** — Structured data standard enabling rich results |
| 36 | and AI engine parsing of question-and-answer content. |
| 37 | **Ahrefs — People Also Ask Mining** — Research methodology for identifying and |
| 38 | prioritizing question-based content from search engine PAA boxes. |
| 39 | |
| 40 | ## When to Use |
| 41 | |
| 42 | "Build FAQ content" |
| 43 | "Target featured snippets" |
| 44 | "People Also Ask strategy" |
| 45 | "Question-based SEO" |
| 46 | "Voice search optimization" |
| 47 | |
| 48 | ## Step-by-Step Process |
| 49 | |
| 50 | ### Phase 1: Question Mining |
| 51 | |
| 52 | Find the questions your ICP is asking: |
| 53 | |
| 54 | **Google People Also Ask:** Search your core keywords. Mine the PAA boxes. |
| 55 | Expand each question for more PAA questions. Repeat 3-4 levels deep. |
| 56 | **Google Autocomplete:** Type your keyword + "how", "what", "why", "when", |
| 57 | "where", "can", "do", "is" — capture all suggestions. |
| 58 | **AnswerThePublic / AlsoAsked.com:** Automated question mining tools |
| 59 | **Reddit:** Search your topic in relevant subreddits. Sort by top posts. |
| 60 | Look for questions in post titles and comments. |
| 61 | **Quora:** Search your topic. Sort by most followed questions. |
| 62 | **Customer conversations:** Sales calls, support tickets, onboarding questions. |
| 63 | These are the questions with real business intent behind them. |
| 64 | **Competitor FAQ pages:** What questions are they answering? What are they |
| 65 | missing that you can own? |
| 66 | |
| 67 | ### Phase 2: Question Prioritization |
| 68 | |
| 69 | Score each question on: |
| 70 | |
| 71 | **Search volume:** 50+ monthly searches preferred |
| 72 | **Business relevance:** Does answering this lead to your product? |
| 73 | **Featured snippet opportunity:** Does the current snippet suck? (Short answer, |
| 74 | no source, from a weak site) |
| 75 | **Competition:** Can you outrank the current #1? Check domain rating of the |
| 76 | page currently ranking. |
| 77 | |
| 78 | ### Phase 3: FAQ Content Structure |
| 79 | |
| 80 | For each question, create a dedicated section: |
| 81 | |
| 82 | **Format for featured snippets:** |
| 83 | |
| 84 | **Question as H2 or H3:** Exact or near-exact match to the query |
| 85 | **Answer in 40-60 words:** Clear, definitive, authoritative. Start with the |
| 86 | answer, then elaborate. This is what Google pulls for the snippet. |
| 87 | **Elaboration:** 100-300 words expanding on the answer with examples, data, |
| 88 | or context |
| 89 | **Related links:** Link to deeper content on the topic |
| 90 | |
| 91 | **FAQ page structure:** |
| 92 | |
| 93 | Group questions by topic (H2 per topic group) |
| 94 | 10-20 questions per page |
| 95 | FAQ schema markup on every question-answer pair |
| 96 | Table of contents at the top (jump links to each question) |
| 97 | CTA after the most business-relevant question |
| 98 | |
| 99 | ### Phase 4: Schema Implementation |
| 100 | |
| 101 | Implement FAQ schema on every question page: |
| 102 | |
| 103 | |
| 104 | { |
| 105 | "@type": "FAQPage", |
| 106 | "mainEntity": [ |
| 107 | { |
| 108 | "@type": "Question", |
| 109 | "name": "What is email verification?", |
| 110 | "acceptedAnswer": { |
| 111 | "@type": "Answer", |
| 112 | "text": "Email verification is the process of..." |
| 113 | } |
| 114 | } |
| 115 | ] |
| 116 | } |
| 117 | |
| 118 | |
| 119 | Since August 2023, Google shows FAQ rich results only for well-known government |
| 120 | and health sites, so do not promise expandable FAQ listings. The markup still |
| 121 | helps search and AI engines parse each question-answer pair. |
| 122 | |
| 123 | ### Phase 5: Measurement |
| 124 | |
| 125 | **Featured snippet wins:** Track which questions you own the snippet for |
| 126 | **PAA appearances:** Track which questions you appear in the PAA box |
| 127 | **FAQ traffic:** Organic traffic to FAQ pages |
| 128 | **FAQ-to-conversion:** How many FAQ visitors go on to product pages, sign up, |
| 129 | or request demos |
| 130 | **Voice search:** Track voice search queries (available in Search Console |
| 131 | with some filtering) |
| 132 | |
| 133 | ## Output Format |
| 134 | |
| 135 | FAQ strategy document with: question inventory, prioritization matrix, content |
| 136 | template, schema implementation, and measurement dashboard. |
| 137 | |
| 138 | ## Quality Check |
| 139 | |
| 140 | Before delivering, verify: |
| 141 | |
| 142 | [ ] All required sections are complete |
| 143 | [ ] Output matches the user's stated need |
| 144 | [ ] Named frameworks are cited for key recommendations |
| 145 | [ ] No vague claims — every recommendation has a specific action |
| 146 | [ ] Deliverable is ready for operational use, not just conceptual |
| 147 | |
| 148 | ## Common Pitfalls |
| 149 | |
| 150 | **Writing for search engines, not humans.** Keyword-stuffed content that reads like a robot wrote it. Fix: write for your ICP first, optimize for search second. |
| 151 | **Publishing and praying.** Creating content without a distribution plan. Fix: every piece gets a 30-day promotion calendar across email, social, and paid. |
| 152 | **Ignoring content freshness.** 2-year-old content with outdated data and examples still ranking. Fix: quarterly content audit — update or retire stale pieces. |
| 153 | |
| 154 | ## Execution Artifacts |
| 155 | |
| 156 | `references/framework-notes.md` — PAA/snippet format, FAQ schema, AEO overlap, Pattern 25 routing |
| 157 | `templates/output-template.md` — Deliverable shell for agent output |
| 158 | `scripts/check-output.py` — Lightweight deliverable validator |
| 159 | `references/seo-strategy-playbook.md` — Repo root: §4 schema, §8 AEO overlap |
| 160 | the `using-gtm-skills` skill — Pattern 25: B2B SEO Stack (step 4) |
| 161 | |
| 162 | ## Related Skills |
| 163 | |
| 164 | seo-strategy, aeo-strategy, pillar-pages, content-marketing, landing-pages |
| 165 |
Discussion
Alternatives
Browse more free Claude skills or everything in Marketing.