Agent skill

Featured Snippet Optimizer

by inhouseseo in inhouseseo/superseo-skills

A skill your agent uses when you want to win a featured snippet for a keyword you already rank for.

Apache-2.0Auto-check passedMarketing & SEO

Install Featured Snippet Optimizer

skills CLI
$ npx skills add inhouseseo/superseo-skills --skill featured-snippet-optimizer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install inhouseseo/superseo-skills featured-snippet-optimizer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/inhouseseo/superseo-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/featured-snippet-optimizer .claude/skills/featured-snippet-optimizer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
featured-snippet-optimizer
GitHub stars
352
Token cost
~2k tokens
SKILL.md length
1,167 words
Files
8 (incl. references)
Skills in repo
11
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses when you want to win a featured snippet for a keyword you already rank for.

  • Works in 8 steps: Check the Current Snippet → Classify the Query Format → Fetch and Read Your Page → …
  • You want to win a featured snippet for a keyword you already rank for
  • SKILL.md covers Input, Role, Step 1: Check the Current… and Step 2: Classify the Query…, plus 9 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Featured Snippet Optimizer is an agent skill from inhouseseo/superseo-skills. Use when you want to win a featured snippet for a keyword you already rank for. The agent checks the current snippet format, analyzes your content, and rewrites the relevant section to match what Google wants.

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files, including reference files (for example `references/aio-vs-snippet-decision.md`, `references/content-types/comparison.md` and `references/content-types/faq-page.md`).

It sits in Marketing & SEO. The repository describes itself as: 11 Claude skills for SEO: page audits, linkbuilding, article writing, E-E-A-T audits, semantic gap analysis, link building. Methodology from Koray Tuğberk, Kyle Roof, and Lily…. The licence is Apache-2.0.

When your agent uses it

  • You want to win a featured snippet for a keyword you already rank for

Example prompts

  • “/featured-snippet-optimizer”

Workflow steps

8 steps, taken from the step headings in SKILL.md.

  1. Check the Current Snippet
  2. Classify the Query Format
  3. Fetch and Read Your Page
  4. Identify the Gap
  5. Rewrite
  6. Supporting Structure
  7. Format-Specific Rules
  8. Output

What it can do on your machine

Read from SKILL.md and the folder at commit 9cf22cc. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • firstpagesage.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Featured Snippet Optimizer loads about 2k tokens when it runs, and up to ~14k if it reads all its reference files. Until then it costs about 59 tokens; SKILL.md has 1,167 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~59
When it runs · the whole SKILL.md, loaded when a task matches
~2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~14k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from inhouseseo/superseo-skills at commit 9cf22cc, republished under its Apache-2.0 licence (© inhouseseo). 1,167 words, ~2,023 tokens.

Download SKILL.mdSave it as .claude/skills/featured-snippet-optimizer/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
name
featured-snippet-optimizer
description
Use when you want to win a featured snippet for a keyword you already rank for. The agent checks the current snippet format, analyzes your content, and rewrites the relevant section to match what Google wants.

Featured snippets get 42.9% CTR versus 39.8% for organic #1 without a snippet (First Page Sage 2026 CTR study). If you're ranking positions 1-5 and NOT holding the snippet, you're leaving clicks on the table. This skill finds the gap and fixes it.

Input

  • Target keyword (required)
  • Your page URL that already ranks for this keyword (required)

If you don't know your current position, tell the user: featured snippet optimization only works for pages ranking positions 1-5. From position 6+, fix the ranking first, then target the snippet.

Role

You are a senior SEO specialist with deep knowledge of featured snippet mechanics. You know that Google picks snippets algorithmically from the top 10, and the format you write in matters more than content quality for this one job.

Step 1: Check the Current Snippet

Google the target keyword. Observe:

  • Is there a featured snippet at all?
  • If yes: which domain holds it? Your domain or a competitor?
  • What format is it? Paragraph / ordered list / unordered list / table
  • What's the exact text of the snippet?

Quote the snippet text exactly as shown. If you can't see the SERP, say so — don't reconstruct it from memory.

If there's NO featured snippet at all, that's actually good news — the slot is up for grabs.

Step 2: Classify the Query Format

Google uses format matching. The query type dictates the snippet format:

Query typeSnippet formatExample query
"What is X"Paragraph (40-60 words)"what is affiliate marketing"
"How to X"Ordered list"how to bake sourdough"
"X list" or "types of X"Unordered list"types of cheese"
"X vs Y"Table or paragraph"react vs vue"
"Best X" / "top X"Unordered list with brief"best running shoes"
"When did X" / "who is X"Short paragraph (< 50 words)"when did rome fall"
Numeric answerShort phrase or table"how much is tesla stock"

Apply the rule: write the answer in the exact format Google wants. If it's a "how to" query, you need ordered steps. If it's a "what is", you need a paragraph of 40-60 words.

Step 3: Fetch and Read Your Page

Read your current page. Find where you (try to) answer the target query. Check:

  • Does the answer appear? If yes, where? (First paragraph, under an H2, deep in the article?)
  • Is the format right for the query type?
  • Is the answer clean and self-contained, or does it require context from surrounding paragraphs?
  • How long is it? (40-60 words for paragraph snippets; 3-8 steps for list snippets)

Step 4: Identify the Gap

The most common failures:

  • Wrong format — you wrote a paragraph when Google wants a list
  • Answer too long — Google truncates at ~60 words for paragraph; 8-10 items for list
  • Answer too short — Google wants a complete thought
  • Answer is buried — it's in the middle of the article, not directly under an H2 that matches the query
  • No self-contained answer — the answer depends on the surrounding context to make sense
  • Not in a heading-answer structure — Google looks for H2/H3 followed immediately by the answer

Step 5: Rewrite

Write a new version of the answer section, optimized for the snippet. The rewrite should:

  1. Start with an H2 or H3 that restates the query — literally "What is affiliate marketing?" as an H2
  2. Answer directly and completely in the first 40-60 words — no preamble, no "it depends," no "as we'll explain below"
  3. Use the correct format — paragraph / ordered list / unordered list / table
  4. Be self-contained — a reader should understand the answer without reading anything else on the page
  5. Include the target keyword naturally in the first 20 words

Provide two versions:

  • The featured snippet answer block — 40-60 words or 3-8 list items, exactly what you want Google to pull
  • A longer follow-up paragraph — for the reader who wants more depth after the snippet block

Step 6: Supporting Structure

In addition to the answer block, add:

  • An H2 with the exact query phrasing immediately above the answer
  • A short intro of 1-2 sentences between the H2 and the answer (optional, helps scannability)
  • The 40-60 word answer OR the 3-8 step list
  • A deeper explanation AFTER the answer block

Google's snippet extractor looks at this structure specifically. The answer block should be the FIRST substantial thing under the matching H2.

Show full SKILL.md (455 more words)Show less

Step 7: Format-Specific Rules

For paragraph snippets (40-60 words):
  • Complete sentence structure — subject, verb, object
  • Direct definition or answer
  • No "in this guide we'll cover..." fluff
  • Include the target term in the first 20 words
For ordered list snippets (how-to):
  • 3-8 steps maximum
  • Each step = one action verb + one sentence
  • Steps must be self-contained (don't reference previous steps implicitly)
  • Use "1. 2. 3." numbering that Google can parse
For table snippets (comparisons):
  • Clear column headers
  • 3-6 rows usually
  • Keep each cell short (1-10 words)

Step 8: Output

Current State
  • Keyword | Current snippet holder | Snippet format present | Snippet text
Your Page Analysis
  • URL | Current position (if known) | Where the answer appears | Format gap
Rewrite

New H2: [exact heading] New answer block: [the 40-60 word paragraph OR the 3-8 step list] Supporting follow-up: [the longer paragraph that comes after]

Implementation Notes
  • Place the new answer block here: [specific location in the existing content]
  • Keep the rest of the page intact — don't rewrite surrounding sections
  • The FIRST instance of this answer format on the page is what Google extracts
Realistic Timeline
  • Google typically picks up snippet changes within 1-4 weeks
  • If no change in 4 weeks, check whether your H2 matches the query phrasing closely enough
  • Don't make further changes for at least 2 weeks after the rewrite — let Google reprocess

What to Ignore

  • Targeting snippets from position 6+ — optimize the ranking first
  • Chasing snippets for AI-Overview-heavy queries — AIO has mostly replaced snippets for informational intent. Check first whether a snippet actually shows.
  • Markup tricks — schema doesn't help with featured snippets (only rich results)
  • Keyword stuffing the answer — Google picks clean, natural answers. One instance of the keyword in the first 20 words is enough.

Next Step

For a full content rewrite where the snippet is just one goal: use improve-content with your URL.

Bundled references

Load from references/ only when the step calls for them.

  • query-format-matching-expanded.md — expanded query → snippet format mapping beyond the Step 2 table, with edge cases (hybrid queries, "how much" vs "how many", qualifier queries) (Step 2, when the query type is ambiguous)
  • snippet-format-templates.md — copy-paste answer block templates for paragraph, ordered list, unordered list, and table snippets with word counts and structure (Step 5, when writing the rewrite)
  • aio-vs-snippet-decision.md — when to chase the AI Overview instead of (or alongside) the featured snippet, and how the calculus changes for informational queries (Step 1, when the SERP has both)
  • structured-data-snippets.md — schema markup that helps rich results even though it doesn't help featured snippets directly (optional, when the user wants both)

Snippet-friendly content type templates (references/content-types/) — load the matching one when the rewrite scope expands from answer block to full section:

  • how-to.md — for ordered list snippets
  • faq-page.md — for paragraph snippet stacks from PAA
  • comparison.md — for table snippets

© inhouseseo, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 7 other files (references) in skills/featured-snippet-optimizer of inhouseseo/superseo-skills.

  • SKILL.md
  • references/aio-vs-snippet-decision.md
  • references/content-types/comparison.md
  • references/content-types/faq-page.md
  • references/content-types/how-to.md
  • references/query-format-matching-expanded.md
  • references/snippet-format-templates.md
  • references/structured-data-snippets.md

Open the folder on GitHubat commit 9cf22cc

Compare with similar skills

Featured Snippet Optimizer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Featured Snippet Optimizer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Featured Snippet Optimizer this skillinhouseseo/superseo-skills352—~2kAutomated safety check: PassApache-2.0
Geo Fundamentalswasp-lang/wasp19k9 repos~861Automated safety check: PassMIT
Ab Testingcoreyhaines31/marketingskills54k3 repos~3.1kAutomated safety check: PassMIT
Hreflang and International SEOAgriciDaniel/claude-seo19k5 repos~3.4kAutomated safety check: PassMIT
Referralscoreyhaines31/marketingskills54k2 repos~2.6kAutomated safety check: PassMIT
SEO GeoReScienceLab/opc-skills1.8k4 repos~2.1kAutomated safety check: PassApache-2.0

Similar skills

  • Geo Fundamentals

    wasp-lang/wasp

    Generative Engine Optimization for AI search engines (ChatGPT, Claude, Perplexity).

    19k GitHub starsUsed in 9 repos~861 tokens
    Marketing & SEOAuto-check passed
  • Ab Testing

    coreyhaines31/marketingskills

    When the user wants to plan, design, or implement an A/B test or experiment, or build a growth experimentation program.

    54k GitHub starsUsed in 3 repos~3.1k tokens
    Marketing & SEOAuto-check passed
  • Hreflang and International SEO

    AgriciDaniel/claude-seo

    Audits, validates and generates hreflang tags for multi-language and multi-region sites in HTML, HTTP headers or XML sitemaps, flagging common code and return-tag mistakes.

    19k GitHub starsUsed in 5 repos~3.4k tokens
    Marketing & SEOAuto-check passed
  • Referrals

    coreyhaines31/marketingskills

    When the user wants to create, optimize, or analyze a referral program, affiliate program, or word-of-mouth strategy.

    54k GitHub starsUsed in 2 repos~2.6k tokens
    Marketing & SEOAuto-check passed
  • SEO Geo

    ReScienceLab/opc-skills

    SEO & GEO (Generative Engine Optimization) for websites. An agent skill from ReScienceLab/opc-skills.

    1.8k GitHub starsUsed in 4 repos~2.1k tokens
    Marketing & SEOAuto-check passed
  • Ad Creative

    LeoYeAI/openclaw-marketing-skills

    When the user wants to generate, iterate, or scale ad creative — headlines, descriptions, primary text, or full ad variations — for any paid advertising platform.

    1k GitHub starsUsed in 8 repos~3.4k tokens
    Marketing & SEOAuto-check passed

More from inhouseseo/superseo-skills

All 11 skills in this repo
  • Content Brief

    inhouseseo/superseo-skills

    A skill your agent uses when planning a new article. An agent skill from inhouseseo/superseo-skills.

    352 GitHub stars~1.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Eeat Audit

    inhouseseo/superseo-skills

    A skill your agent uses when auditing a page for E-E-A-T signals.

    352 GitHub stars~1.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Expert Interview

    inhouseseo/superseo-skills

    A skill your agent uses when extracting first-party expertise from a subject-matter expert before writing content.

    352 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Improve Content

    inhouseseo/superseo-skills

    A skill your agent uses when rewriting or refreshing an existing page that's underperforming.

    352 GitHub stars~1.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Keyword Deep Dive

    inhouseseo/superseo-skills

    A skill your agent uses when planning to rank for a specific keyword.

    352 GitHub stars~1.7k tokensUpdated 1 mo ago
    Auto-check passed
  • Linkbuilding

    inhouseseo/superseo-skills

    A skill your agent uses when planning link acquisition. An agent skill from inhouseseo/superseo-skills.

    352 GitHub stars~1.7k tokensUpdated 1 mo ago
    Auto-check passed

Categories

Questions about Featured Snippet Optimizer

What does Featured Snippet Optimizer do?

A skill your agent uses when you want to win a featured snippet for a keyword you already rank for. Featured Snippet Optimizer is an agent skill from inhouseseo/superseo-skills. Use when you want to win a featured snippet for a keyword you already rank for.

When should I use Featured Snippet Optimizer?

Featured Snippet Optimizer fits situations like: you want to win a featured snippet for a keyword you already rank for.

How do I install Featured Snippet Optimizer in Claude Code?

Run `npx skills add inhouseseo/superseo-skills --skill featured-snippet-optimizer -a claude-code`. Or copy the skill folder (skills/featured-snippet-optimizer in inhouseseo/superseo-skills) into .claude/skills/featured-snippet-optimizer in your project. Claude Code loads it when a task matches its description.

How do I install Featured Snippet Optimizer in Codex?

Run `npx skills add inhouseseo/superseo-skills --skill featured-snippet-optimizer -a codex`. Or copy the skill folder (skills/featured-snippet-optimizer in inhouseseo/superseo-skills) into .agents/skills/featured-snippet-optimizer in your project. Codex loads it when a task matches its description.

Can I use Featured Snippet Optimizer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add inhouseseo/superseo-skills --skill featured-snippet-optimizer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/featured-snippet-optimizer, .gemini/skills/featured-snippet-optimizer, .github/skills/featured-snippet-optimizer and .opencode/skills/featured-snippet-optimizer in your project.

What does Featured Snippet Optimizer need to run?

SKILL.md names no scripts, command-line tools or credentials: Featured Snippet Optimizer is instructions for the agent only.

Does Featured Snippet Optimizer access the network?

SKILL.md names 1 domain. As links in the text: firstpagesage.com. This is read from the text; nothing was executed.

Is Featured Snippet Optimizer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Featured Snippet Optimizer use?

Featured Snippet Optimizer is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Featured Snippet Optimizer use?

About 2k tokens (SKILL.md is roughly 8.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 12k tokens, read only when the agent opens those files.

What are the alternatives to Featured Snippet Optimizer?

Skills that share tags, products or a category with Featured Snippet Optimizer: Geo Fundamentals (wasp-lang/wasp, 19k stars), Ab Testing (coreyhaines31/marketingskills, 54k stars), Hreflang and International SEO (AgriciDaniel/claude-seo, 19k stars) and Referrals (coreyhaines31/marketingskills, 54k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Featured Snippet Optimizer?

inhouseseo (a GitHub user) maintains it in inhouseseo/superseo-skills, which has 352 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on September 3, 2026.

Source: inhouseseo/superseo-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.