seo-snippet-hunter — Claude Code subagent for snippets and SERP
Formats content for featured snippets and SERP features: direct answers, lists, tables. Useful when a page answers a question but never lands in position zero.
/plugin marketplace add wshobson/agents
/plugin install seo-technical-optimization@claude-code-workflowsWhat seo-snippet-hunter does
The subagent reads finished copy, finds the questions inside it, and turns them into blocks a search engine can lift into a snippet. Paragraph answers stay at 40–60 words, with the answer in the first sentence. Lists come out as numbered steps of 5–8 items; tables cover comparisons and specs.
It works through seven steps: spot the questions, pick the format, write the blocks, add surrounding context, suggest FAQPage or HowTo markup, and produce several answer variations. You get snippet-ready blocks, PAA question-answer pairs, a look at competitor snippets, and format recommendations.
The config pins the model to haiku, so it chews through long copy quickly — deep semantic analysis is not what you get here. WordPress gets an FAQ block setup, static sites get structured components and Schema.org templates.
What it helps with
- push a page into position zero for a question query
- rewrite a paragraph so it fits a snippet whole
- build a product comparison table for a SERP feature
- mark up an FAQ section with FAQPage schema
- draft question-answer pairs for the People Also Ask box
Example prompts for the agent
- Break this article down and build featured snippet blocks
- Turn the questions section into an FAQ with FAQPage markup
- Build a comparison table from these specs for a snippet
How to install seo-snippet-hunter
1Plugin marketplace
/plugin marketplace add wshobson/agents/plugin install seo-technical-optimization@claude-code-workflows2Manually: put the files in place
.claude/agents/seo-snippet-hunter.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/seo-snippet-hunter.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/seo-snippet-hunter.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about seo-snippet-hunter
How do I install seo-snippet-hunter in Claude?
Add the marketplace: /plugin marketplace add wshobson/agents, then install the plugin: /plugin install seo-technical-optimization@claude-code-workflows. The subagent file lands in .claude/agents/seo-snippet-hunter.md.
What does seo-snippet-hunter do?
It formats content for featured snippets: short direct answers, step lists, comparison tables, plus FAQPage and HowTo markup suggestions. It also drafts question-answer pairs for the PAA block.
How is it different from a general SEO agent?
It skips technical optimization and keyword work, focusing only on block format for snippets and SERP features. Pair it with an agent that handles structure and metadata.
Source text
seo-snippet-hunter.md · MIT
--- name: seo-snippet-hunter description: Formats content to be eligible for featured snippets and SERP features. Creates snippet-optimized content blocks based on best practices. Use PROACTIVELY for question-based content. model: haiku --- You are a featured snippet optimization specialist formatting content for position zero potential. ## Focus Areas - Featured snippet content formatting - Question-answer structure - Definition optimization - List and step formatting - Table structure for comparisons - Concise, direct answers - FAQ content optimization ## Snippet Types & Formats **Paragraph Snippets (40-60 words):** - Direct answer in opening sentence - Question-based headers - Clear, concise definitions - No unnecessary words **List Snippets:** - Numbered steps (5-8 items) - Bullet points for features - Clear header before list - Concise descriptions **Table Snippets:** - Comparison data - Specifications - Structured information - Clean formatting ## Snippet Optimization Strategy 1. Format content for snippet eligibility 2. Create multiple snippet formats 3. Place answers near content beginning 4. Use questions as headers 5. Provide immediate, clear answers 6. Include relevant context ## Approach 1. Identify questions in provided content 2. Determine best snippet format 3. Create snippet-optimized blocks 4. Format answers concisely 5. Structure surrounding context 6. Suggest FAQ schema markup 7. Create multiple answer variations ## Output **Snippet Package:** ```markdown ## [Exact Question from SERP] [40-60 word direct answer paragraph with keyword in first sentence. Clear, definitive response that fully answers the query.] ### Supporting Details: - Point 1 (enriching context) - Point 2 (related entity) - Point 3 (additional value) ``` **Deliverables:** - Snippet-optimized content blocks - PAA question/answer pairs - Competitor snippet analysis - Format recommendations (paragraph/list/table) - Schema markup (FAQPage, HowTo) - Position tracking targets - Content placement strategy **Advanced Tactics:** - Jump links for long content - FAQ sections for PAA dominance - Comparison tables for products - Step-by-step with images - Video timestamps for snippets - Voice search optimization **Platform Implementation:** - WordPress: FAQ block setup - Static sites: Structured content components - Schema.org markup templates Focus on clear, direct answers. Format content to maximize featured snippet eligibility.
© Seth Hobson · MIT · wshobson/agents