aeo-optimizer
Optimize an article for Answer Engine Optimization (AEO) so AI engines like ChatGPT, Perplexity, and Claude can extract, quote, and cite it. Use when asked to AEO-optimize, make content AI-readable, improve AI citation chances, or adapt an article for answer engines. Produces an AEO-optimised rewrite with question headings, 50–80 word answer capsules, a paragraph-length audit, and flagged trust signals.
npx skills add mohitagw15856/pm-claude-skills --skill aeo-optimizer --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
What it does
The skill rewrites an article so AI engines can extract quotable answers. It converts each H2 into a direct question, adds a 50–80 word answer capsule under each question, trims paragraphs to ≤3 sentences, and preserves trust signals while lightly emphasizing them. It outputs a full AEO-ready article and a separate audit report.
How it works
The agent ingests the article (paste or URL fetch), counts headings, and scores AEO readiness. It rewrites each H2 as a direct question, then adds a 50–80 word capsule under every H2. It trims overly long paragraphs, maintains original voice, and flags trust signals present or missing. Finally, it produces Deliverable 1 (AEO-Ready Article) and Deliverable 2 (AEO Audit Report).
When to use it
Use when the goal is to optimize content for AI extraction and citation by engines like ChatGPT, Perplexity, and Claude. Triggered by requests to AEO-optimize, improve AI readability, or adapt articles for answer engines.
What it can touch
Tools listed: claude-code, cursor. The skill engages these tools to ingest content, rewrite headings, insert capsules, and run the audit.
Caveats
License: MIT. Category: Security. Declared inputs include article content and optional metadata. Output follows the specified structure and formatting rules; no speculative outcomes are promised.
# AEO Optimizer Skill AEO — Answer Engine Optimization — is the discipline of structuring content so that AI engines (ChatGPT, Perplexity, Claude, Gemini) can extract clean, quotable answers and confidently cite your content as a source. Most articles are written for humans who scroll, skim, and click. AI engines don't scroll — they scan for extractable answer units. They look for short, self-contained answer blocks sitting directly beneath a clear question heading. If they can't find those, they either skip the content or paraphrase it poorly. This skill fixes that. --- ## The AEO Problem Here is what AI engines are scanning for, and what most articles fail to provide: | What AI engines want | What most articles deliver | |---|---| | H2 = a direct question ("What is X?") | H2 = a vague topic label ("About X" or "Understanding X") | | 50-80 word answer capsule immediately under the heading | Long intro paragraphs before the actual answer | | No links inside the answer block | Inline links that break extractability | | ≤3 sentences per paragraph | Dense 6-8 sentence paragraphs | | Named frameworks, original data, first-person experience | Generic statements with no attribution or sp
- The AEO Problem
- Required Inputs
- Output Structure
- Deliverable 1 — AEO-Ready Article
- Deliverable 2 — AEO Audit Report
- AEO Audit Report
- Heading Rewrites
- Answer Capsule Placements
- Paragraph Length Audit
- Trust Signal Inventory
- AEO Scoring Rubric
- Recommended Next Steps
- How Claude Should Execute This Skill
- Step 1 — Ingest the article
What does the aeo-optimizer skill do?
Optimize an article for Answer Engine Optimization (AEO) so AI engines like ChatGPT, Perplexity, and Claude can extract, quote, and cite it. Use when asked to AEO-optimize, make content AI-readable, improve AI citation chances, or adapt an article for answer engines. Produces an AEO-optimised rewrite with question headings, 50–80 word answer capsules, a paragraph-length audit, and flagged trust signals.
How do I install it?
Run `npx skills add mohitagw15856/pm-claude-skills --skill aeo-optimizer --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From mohitagw15856/pm-claude-skills, a repository with 1,255 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.