FAQ SEO Optimizer

Faq SEO

by LeadMagic · MIT license · ★ 62 on GitHub

Faq SEO cover

Builds question-driven FAQ content that wins featured snippets and People Also Ask placements: question research, answer formatting, FAQ schema, and page placement. Use when the user wants to target featured snippets, PAA boxes, or…

---
name: faq-seo
description: >-
  Builds question-driven FAQ content that wins featured snippets and People Also
  Ask placements: question research, answer formatting, FAQ schema, and page
  placement. Use when the user wants to target featured snippets, PAA boxes, or
  voice search, or needs an FAQ page that ranks. Triggers on: "FAQ SEO",
  "featured snippet", "People Also Ask", "question SEO", "answer content".
license: MIT
compatibility: Claude Code, Codex, GitHub Copilot, Cursor, Gemini CLI, OpenCode, Goose, Hermes, Windsurf, Zed
metadata:
  version: "1.0.0"
  author: LeadMagic
  category: content-seo
  tags: [content-seo, faq, featured-snippets, people-also-ask, questions]
  frameworks:
    - "Google Search Central — SEO Starter Guide"
    - "Schema.org FAQPage Specification"

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.

Manual install (npx, ZIP)
Claude Codenpx skills add LeadMagic/gtm-skills --skill faq-seo -g -a claude-code
Claude Code (degit)npx degit LeadMagic/gtm-skills/skills/content-seo/faq-seo#main ~/.claude/skills/faq-seo
Claude.ai / desktopZip the folder and upload it under Settings → Capabilities → Skills.
Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

  • SKILL.md6.2 KB
Read SKILL.md here
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 
View all files on GitHub →

Details

License
MIT
Stars on the repo
★ 62
Checked
Source
LeadMagic/gtm-skills ↗
Creator
LeadMagic · 129 listings
View creator

Similar skills

See all →
SkillAgent Browsing AuditorAgriciDaniel/claude-seo · by AgriciDanielAudit 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).★ 17.4k GitHub starsSkillBacklink Profile AnalysisAgriciDaniel/claude-seo · by AgriciDanielBacklink 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.★ 17.4k GitHub starsSkillCMS Configuration Helpernowork-studio/notfair-plugin · by nowork-studioConnect 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.★ 3.9k GitHub starsSkillBacklink Comparison ToolRyze-AI-Adgent/open-seo-mcp-skills · by Ryze-AI-AdgentBacklink 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".★ 3.1k GitHub starsSkillWeb Vitals Auditoraddyosmani/web-quality-skills · by addyosmaniOptimize Core Web Vitals (LCP, INP, CLS) for better page experience using field and lab evidence. Use when asked to "improve Core Web Vitals", "fix LCP", "reduce CLS", "optimize INP", "page experience optimization", or "fix layout shifts".★ 2.8k GitHub starsSkillSEO Publishing Looptsingyuai/growth-lab · by tsingyuaiRun an SEO page observation-action-review loop with persistent Memory by coordinating demand research, page creation, adversarial review, image generation, IndexNow submission, and performance review. Use when taking an SEO page from opportunity discovery through publication, measurement, iteration, or continuing a previous SEO loop from Memory.★ 2k GitHub stars

More from LeadMagic

SkillFirst-Party Analytics SetupLeadMagic/gtm-skills · by LeadMagicSet up first-party tracking and analytics — website pixels, conversion tracking, UTM architecture, cookie consent, server-side tagging vs client-side, 1P vs 3P data strategy, and identity resolution. Use when setting up tracking, implementing pixels, building attribution, or preparing for privacy-first measurement. Triggers on: "pixel", "tracking", "conversion tracking", "first-party data", server-side tagging", "UTM", "cookie consent", "1P vs 3P", "identity resolution", or any tracking implementation request.★ 62 GitHub starsSkillStrategic Account MarketingLeadMagic/gtm-skills · by LeadMagicRuns strategic 1-to-1 ABM for 5-15 high-value accounts: account plans, custom microsites, executive engagement, direct mail, and board-level connections. Use when a named enterprise account justifies bespoke content and executive time, or when the user needs a strategic account plan. Triggers on: "1-to-1 ABM", "strategic ABM", "custom ABM", "key account marketing", "named account".★ 62 GitHub starsSkillCluster Account MarketingLeadMagic/gtm-skills · by LeadMagicRuns ABM at scale (1-to-few) for 15-50 clustered accounts: industry or persona clusters, semi-custom campaigns, and cluster-level content. Use when named-account ABM needs to reach more accounts without bespoke work per account. Triggers on: "1-to-few ABM", "ABM scale", "cluster ABM", "industry ABM".★ 62 GitHub starsSkillProgrammatic Account TargetingLeadMagic/gtm-skills · by LeadMagicRuns programmatic 1-to-many ABM for 50-200+ accounts: automated personalization, scaled outbound, intent-based targeting, and lookalike expansion. Use when ABM coverage must grow without adding headcount or when the user wants automated account-based outreach. Triggers on: "1-to-many ABM", programmatic ABM", "scaled ABM", "automated ABM".★ 62 GitHub starsSkillAccount Strategy DesignerLeadMagic/gtm-skills · by LeadMagicDesigns an account-based marketing program: tier selection, account scoring, channel orchestration, BDR alignment (account-based sales development), and a measurement framework. Use when the user is launching or redesigning ABM, choosing between 1-to-1, 1-to-few, and 1-to-many, or building a target account program. Triggers on: "ABM strategy", "account based marketing", "ABM playbook", "design ABM", "target accounts", "ABSD", "account based sales development", "Lars Nilsson".★ 62 GitHub starsSkillTarget Account SelectorLeadMagic/gtm-skills · by LeadMagicBuilds and tiers a target account list: fit and intent scoring models, tier assignment, and TAM segmentation. Use when the user needs to decide which accounts to target, score or tier an account list, or prioritize a TAM for ABM or outbound. Triggers on: "account selection", "target account list", "tier accounts", "prioritize accounts", "TAM segmentation".★ 62 GitHub stars