answer-engine-optimization · git:20261108.80f295b · 2026-11-08 · sha256 ed699c540fb62cf3

answer-engine-optimization git:20261108.80f295bB

Immutable. This exact content never changes and is served at /api/v1/blob/ed699c540fb62cf3.

No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_a3udrx52qd5z2c4l/ed699c540fb62cf3bb99959cbf348ce2d8cea56a2758cbe2aa8859bb0b7afa61.json

Then /plugin install answer-engine-optimization@markdownregistry-a3udrx52qd5z2c4l in Claude Code. It installs this exact version, the one graded B here, pinned to the commit it was graded at, and leaves it there.

---
name: answer-engine-optimization
description: Optimize content structure for featured snippets, Google AI Overviews, Perplexity, and ChatGPT Search with direct answer capsules, question H2s, labeled comparison tables, quantified facts, and FAQ parity.
---

# answer-engine-optimization — Answer Engine & Featured Snippet Optimization (AEO)

## 1. Description & Activation Criteria

Activate `answer-engine-optimization` when the user wants to:

- Win featured snippets, "People Also Ask" (PAA) expansions, Google AI Overviews, Perplexity citations, and ChatGPT Search passages.
- Structure prose into high-signal answer capsules (`C02-answer` P1), extractable lists/tables (`C03-extractable` P2, `C05-table-headers` P3), natural question headings (`G07-question-headings` P3), quantified facts (`G03-facts` P2, `G08-stat-density` P3), and synchronized visible + JSON-LD FAQs (`C04-faq` P1/P2, `S03-faq-parity` P3).
- Ensure snippet controls (`G09-snippet-controls` P2) do not block passage extraction.

## 2. Inputs & Prerequisites

- **Target**: Informational guides, documentation pages (`--profile docs`), comparison articles, or landing pages (live URL or local HTML).
- **Key CLI filters**:
  - `--skills answer-engine-optimization` (alias: `aeo`, `featured-snippets`).
  - `--profile docs`: Elevates `C04-faq` and `G01-llms` to `P1` for documentation hubs where Q&A retrieval is primary.

## 3. Step-by-Step Workflow

1. **Run an AEO-focused audit**:
   - Execute `npx one-step-seo page <url> --skills answer-engine-optimization --out ./seo-report` and `npx one-step-seo ai <url> --json`.
2. **Verify snippet eligibility (`G09-snippet-controls`)**:
   - Ensure neither `<meta name="robots">` nor `X-Robots-Tag` contains `nosnippet` or `max-snippet:0` (`G09-snippet-controls` P2), which blocks both classic featured snippets and AI Overview passage quoting. Use `data-nosnippet` selectively on cookie banners or nav chrome instead.
3. **Craft the 40–60 word Answer-First Capsule (`C02-answer`)**:
   - Worth **25/100 points** on the AI Visibility score (`GEO_WEIGHTS`).
   - Within the first ~120 words of body copy, pose the core user question (`What/Why/How/When/Where/Which/Who ...?`) or a `TL;DR:` / `In short:` lead-in followed immediately by a self-contained 40–60 word factual definition or direct answer.
4. **Convert walls of prose into extractable structures (`C03-extractable`, `C05-table-headers`, `G07-question-headings`)**:
   - Phrase at least half of `<h2>` headings (on pages with 3+ H2s) as real user questions (`G07-question-headings` P3).
   - Add ordered `<ol>` step lists for procedural "How-to" queries and semantic `<table>` grids with explicit `<th>` column headers (`C03-extractable` P2, `C05-table-headers` P3) for comparisons, specs, and pricing.
5. **Synchronize visible FAQs with `FAQPage` JSON-LD (`C04-faq`, `S03-faq-parity`)**:
   - Add 3–6 genuine user questions and concise answers on-page (`C04-faq`), and keep `<script type="application/ld+json">` `FAQPage` nodes 1:1 synchronized with visible copy (`S03-faq-parity` P3).

## 4. Tools & CLI Commands

```bash
# Audit answer-engine and snippet signals on a guide or docs page
npx one-step-seo page https://example.com/guides/what-is-rag --skills aeo --out ./seo-report

# Audit documentation pages with docs profile calibration
npx one-step-seo audit https://example.com/docs --pages 15 --profile docs --skills answer-engine-optimization --out ./seo-report

# Generate a starter FAQPage JSON-LD block to pair with visible FAQ copy
npx one-step-seo schema https://example.com/guides/what-is-rag --generate faq
```

## 5. Evidence Requirements

- Report both `report.scores.ai.score` (`report.scores.ai.band`) and `report.scores.search.score` (`report.scores.search.band`) separately.
- Quote `C02-answer`, `C03-extractable`, `C04-faq`, `C05-table-headers`, `G03-facts`, `G07-question-headings`, `G08-stat-density`, `G09-snippet-controls`, and `S03-faq-parity` `evidence` strings from `report.findings`.

## 6. Expected Outputs

1. **AEO Readiness Breakdown**: Status of snippet eligibility, answer capsule, question H2 ratio, table header hygiene, stat density, and FAQ parity.
2. **Answer Capsule & Heading Rewrite**: A crisp 40–60 word opening answer block and question-shaped H2 outline derived strictly from existing page facts.
3. **Synchronized FAQ HTML + JSON-LD**: Matching `<section>` FAQ markup and `FAQPage` JSON-LD.

## 7. Limitations & External Data

- **Structural readiness vs SERP volatility**: Featured snippets and AI Overviews depend on live query intent and search index competition; `one-step-seo` verifies deterministic structural extractability, never guaranteed SERP placement.
- **Offline support**: 100% supported on local Markdown-rendered HTML and static builds (`--offline`).

## 8. Safety & Approval Rules

- **Never invent statistics, benchmarks, or citations**: When remediating `G03-facts` or `G08-stat-density`, extract real numbers already stated on the page or use explicit `[TODO: insert verified metric + source]` markers.
- Never add `FAQPage` JSON-LD for questions that are hidden or absent from the visible page (`S03-faq-parity`).

## 9. Examples

```bash
# Inspect the answer-engine-optimization skill checks and aliases
npx one-step-seo skills answer-engine-optimization

# Run an offline AEO audit on built documentation HTML
npx one-step-seo audit ./dist/docs --pages 10 --profile docs --skills aeo --offline --out ./seo-report
```