All skills
inhouseseo avatar

/featured-snippet-optimizer

@bdb4922

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.

Use this Skill: https://skilld.dev/gh/inhouseseo/superseo-skills/featured-snippet-optimizer

This session only. Nothing lands on disk.

referencessnippet-format-templates.md

≈2.6k tokens on demand. Your agent reads this file only when SKILL.md points to it.

Snippet Format Templates — Worked Examples

Each format below has three failing versions paired with the rewrite that would win the snippet. Copy the structure, not the content.

Paragraph Snippets (40-60 words)

Paragraphs are 70% of all featured snippets (Semrush/Ghergich study). The target is 40-60 words, with 45 words being the statistical sweet spot. Every example below is a real failure pattern — answer buried, format wrong, or structure missing the H2-then-answer handoff.

Example 1: "what is content marketing"

Failing version (a 300-word paragraph buried under an H3 on the fourth scroll of a marketing blog):

The rise of content marketing

In today's digital landscape, marketers are constantly searching for new ways to reach their audiences. One approach that has gained significant traction over the last decade is content marketing. But what exactly does that mean? To understand content marketing, we first need to look at how traditional advertising has failed... [continues for 14 more sentences before the actual definition appears]

Winning rewrite (new H2, 47 words, immediately under the heading):

What is content marketing?

Content marketing is a strategy where businesses create and share articles, videos, and other media to attract and retain customers. Instead of directly promoting a product, content marketing builds trust by providing useful information that answers questions the audience already has.

Word count: 47. Keyword in the first five words. Self-contained definition. The rest of the page can now expand into history, examples, and tactics — but the snippet block owns the top of the section.

Example 2: "what does SEO stand for"

Failing version (the acronym explained three paragraphs into an article, after an anecdote):

When I started my first blog in 2008, I had no idea what I was doing. I spent weeks writing posts that nobody read. Eventually a friend told me I needed to learn about SEO. At first I thought SEO was a made-up word. It turns out SEO stands for Search Engine Optimization, which is the practice of...

Winning rewrite (new H2, 25-word answer block):

What does SEO stand for?

SEO stands for Search Engine Optimization. It's the practice of improving a website so it ranks higher in search engines like Google for relevant queries.

Word count: 25. The first sentence is the literal answer. The second adds one line of context. No narrative, no preamble.

Example 3: "what is a backlink"

Failing version (the definition mixed into a glossary section listing 40 SEO terms):

Backlink — See also: inbound link, external link. A backlink is when another website links to your website. This is important for SEO, as discussed in the section on link building above. Related: dofollow, nofollow, anchor text.

Winning rewrite (standalone H2, 45 words, no cross-references):

What is a backlink?

A backlink is a link from another website that points to your website. Search engines treat backlinks as signals of authority — pages with more high-quality backlinks tend to rank higher. A backlink is also called an inbound link or external link.

Word count: 45. The definition is self-contained. A reader who lands on the H2 understands the concept without scrolling up.

Ordered List Snippets (How-To)

Ordered lists work for "how to", "how do I", and "steps to" queries. Google pulls 3-8 steps; anything longer gets truncated. Each step needs to be a complete action the reader can execute without reading the previous step in full.

Example 1: "how to change a flat tire"

Failing version (prose narrative in six paragraphs, no <ol>, no action verbs at the start):

The first thing you want to do is make sure your car is in a safe location. Pull onto a flat, stable surface, away from traffic. Then you'll need to locate your spare tire and jack, which are usually in the trunk...

Winning rewrite (H2, six numbered steps with action verbs, one sentence each):

How to change a flat tire

  1. Park on a flat surface and engage the parking brake.
  2. Remove the hubcap and loosen the lug nuts with a wrench.
  3. Place the jack under the car's frame and raise the vehicle.
  4. Unscrew the lug nuts and remove the flat tire.
  5. Mount the spare tire and hand-tighten the lug nuts.
  6. Lower the car, fully tighten the lug nuts, and store the flat.

Six steps, each under 15 words, each starting with an action verb. The <ol> structure is what Google extracts.

Example 2: "how to start a blog"

Failing version (15 steps, each with paragraph-length explanations):

  1. First, you need to find your niche. Think about what you're passionate about, what you know, and what has an audience. Spend at least a week researching before you commit...
  2. Next, brainstorm a domain name. This is crucial because your domain is your brand... [continues through step 15]

Google truncates lists at 8 items and each item at ~20 words. 15 steps with paragraph explanations lose on both counts.

Winning rewrite (5 steps condensed, each under 20 words):

How to start a blog

  1. Pick a niche you know well and that has a searchable audience.
  2. Buy a domain name and sign up for a hosting provider.
  3. Install WordPress or another content management system.
  4. Choose a theme and write your first three articles.
  5. Publish and share on one social channel where your audience already hangs out.

Five steps, all under the truncation limit. The long version can still live on the page as a deeper explainer below the snippet block.

Example 3: "how to meal prep"

Failing version (steps that run to 40+ words each):

  1. Start by planning your meals for the week. Sit down on Sunday morning with a notebook and think about what you've eaten recently, what's on sale at the grocery store, what ingredients you already have in your pantry, and what your nutrition goals are for the coming week.
  2. Next, make a shopping list based on those meals...

Winning rewrite (steps under 20 words each):

How to meal prep

  1. Plan five meals for the week and write down the ingredients.
  2. Shop for everything in one trip to save time.
  3. Cook all proteins and grains in one 90-minute session.
  4. Portion meals into containers and refrigerate or freeze.
  5. Reheat each day and eat within five days.

Unordered List Snippets

Unordered lists fit "types of X", "best X", and "signs of X" queries. Same rules as ordered lists — 5-8 items, short phrasing, parallel structure.

Example 1: "types of coffee drinks"

Types of coffee drinks

  • Espresso
  • Americano
  • Latte
  • Cappuccino
  • Macchiato
  • Mocha
  • Cortado
  • Flat white

Eight items, each one word (or two), all nouns. Google renders this directly.

Example 2: "best running shoes for beginners"

Best running shoes for beginners

  • Brooks Ghost 16 — cushioned neutral shoe for road running
  • Hoka Clifton 10 — maximum cushioning with a smooth heel-to-toe transition
  • Asics Gel-Kayano 32 — stability shoe for mild overpronation
  • New Balance 880v15 — durable daily trainer for high mileage
  • Nike Pegasus 41 — versatile neutral shoe that handles speed work
  • Saucony Ride 18 — balanced cushioning for new runners

Six items. Brand name first, then a 5-8 word descriptor. The dash separator reads cleanly in Google's snippet renderer.

Example 3: "signs of burnout"

Signs of burnout

  • Chronic exhaustion that sleep doesn't fix
  • Cynicism or detachment from work
  • Reduced professional effectiveness
  • Frequent headaches or muscle pain
  • Difficulty concentrating on simple tasks
  • Loss of motivation for things you used to enjoy
  • Increased irritability with colleagues or family

Seven items, each a short symptom phrase. All under 10 words. No "1." numbering — this isn't a sequence.

Table Snippets (Comparisons)

Tables fit "X vs Y" and pricing queries. Use a real <table> element with <thead> and <tbody>. 3-6 rows, 3-5 columns, short cell content.

Example 1: "iPhone vs Android"

iPhone vs Android

Feature iPhone Android
Operating system iOS (closed source) Android (open source)
App store Apple App Store only Google Play + third-party
Customization Limited Extensive
Price range $429-$1,599 $100-$1,799

4 rows, 3 columns, cells under 10 words. Header column tells the comparison dimension; the two product columns give the facts.

Example 2: "react vs vue vs angular"

React vs Vue vs Angular

Feature React Vue Angular
Maintainer Meta Evan You / core team Google
Learning curve Moderate Gentle Steep
Bundle size ~45KB ~34KB ~150KB
Primary use case SPAs and web apps Lightweight apps Enterprise apps
TypeScript support Optional Optional Built-in

5 rows, 4 columns. Note that 3-way comparisons often get rejected by Google and replaced with an AIO. See aio-vs-snippet-decision.md before committing to this format.

Example 3: "WordPress vs Squarespace"

WordPress vs Squarespace

Aspect WordPress Squarespace
Cost Free software, hosting from $5/mo $16-$52/mo
Ease of use Steeper learning curve Beginner-friendly drag-and-drop
Customization Unlimited via plugins and themes Limited to built-in options
Maintenance Self-managed updates Fully managed

4 rows, 3 columns. Short cells, clear parallels.

Critical Rule: First Instance Wins

Google's snippet extractor reads top to bottom and pulls the first substantial instance of the matching format under the matching H2. If your page has the right H2 but the 40-60 word answer is in paragraph 3 (with paragraphs 1-2 being setup), another page with the answer in paragraph 1 will take the snippet. Same rule for lists — if your ordered list is preceded by three paragraphs of context, Google may still extract, but it's less reliable than a clean H2-then-list handoff.

When rewriting, put the answer block immediately after the H2. Setup, context, and commentary all move below the answer, not above it.

Source: SKILL.md on GitHub

No alerts16d3 checks · Risk SAFE
  • Gen Agent Trust Hub16d

    The skill is functional for search engine optimization but carries a low security risk due to an indirect prompt injection surface when fetching external content from live search results and user-provided URLs.

  • Socket16d

    No alerts

  • Snyk16d

    Risk: LOW · No issues

Signed by skilld at bdb4922. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 3 weeks ago.

Activeupdated last month

README badge

README badge for inhouseseo/superseo-skills/featured-snippet-optimizer