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 ↗

Use now

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

LeadMagic/main1 file shown
SKILL.md
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

  1. 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.
  2. Publishing and praying. Creating content without a distribution plan. Fix: every piece gets a 30-day promotion calendar across email, social, and paid.
  3. 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 routing
  • templates/output-template.md — Deliverable shell for agent output
  • scripts/check-output.py — Lightweight deliverable validator
  • references/seo-strategy-playbook.md — Repo root: §4 schema, §8 AEO overlap
  • the using-gtm-skills skill — Pattern 25: B2B SEO Stack (step 4)
  • seo-strategy, aeo-strategy, pillar-pages, content-marketing, landing-pages
1---
2name: faq-seo
3description: >-
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".
9license: MIT
10compatibility: Claude Code, Codex, GitHub Copilot, Cursor, Gemini CLI, OpenCode, Goose, Hermes, Windsurf, Zed
11metadata:
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 
26FAQ content captures featured snippets (position zero), People Also Ask boxes,
27and voice search results. These are the highest-visibility SERP features —
28and they're often the lowest-competition ranking opportunities. This skill
29covers 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 
52Find 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 
69Score 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 
80For 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 
101Implement FAQ schema on every question page:
102 
103```json
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 
119Since August 2023, Google shows FAQ rich results only for well-known government
120and health sites, so do not promise expandable FAQ listings. The markup still
121helps 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 
135FAQ strategy document with: question inventory, prioritization matrix, content
136template, schema implementation, and measurement dashboard.
137 
138## Quality Check
139 
140Before 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 
1501. **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.
1512. **Publishing and praying.** Creating content without a distribution plan. Fix: every piece gets a 30-day promotion calendar across email, social, and paid.
1523. **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

Agentic Browsing ReadinessAudit and fix agent readiness: the Lighthouse Agentic Browsing fraction, accessibility tree for agents, robots.txt and Content-Signal for AI agents, WAF treatment of agent traffic, llms.txt, Markdown delivery, ai-catalog.json, /.well-known discovery files, and WebMCP tools. Exclude AI citability and brand signals (seo-geo) and commerce protocol depth (seo-ecommerce).Marketing · MITBacklink Profile AnalysisBacklink profile analysis: referring domains, anchor text distribution, toxic link detection, competitor gap analysis. Works with free APIs (Moz, Bing Webmaster, Common Crawl) and DataForSEO extension. Use when user says backlinks, link profile, referring domains, anchor text, toxic links, link gap, link building, disavow, or backlink audit.Marketing · MIT/setup-cmsConnect a CMS to notfair SEO tools. Guides users through configuring WordPress, Strapi, Contentful, or Ghost — tests the connection, and writes credentials to .env.local. Once set up, seo-analysis automatically cross- references CMS content against Google Search Console data. Use whenever the user says "connect my CMS", "set up WordPress", "configure Strapi", "add Contentful", "connect Ghost", or "CMS setup". Also trigger if the user asks why no CMS data appears in a seo-analysis report. · MITBacklink checkBacklink profile for any domain — referring domains, authority, anchors, new/lost links, and a side-by-side vs a competitor. Use when asked "check my backlinks", "backlink profile of X", "who links to them", or "link gap vs competitor".Marketing · MIT