seo-aeo
Skill6 starsChanged 3 months agoApache-2.0View on GitHub
Audit supplied pages, documents, or content sets for direct-answer completeness, question and intent coverage, clarity, extractability, claim support, and visible-content consistency against a pinned AI-search Research Pack. Use for AEO, answer-engine optimization, answer readiness, answer extraction, featured-answer preparation, or requests asking whether content clearly and supportably answers researched questions. Do not use for generative-engine mention/citation strategy, live research, content rewriting, schema generation, technical SEO implementation, or visibility monitoring.
4 other projects use a version of this.
Adopted by
Most recently taken up by
- Solnest-AI/solnest-seo-aeotheir own version, first seen Oct 15, 2026
- BreRoz/ClaudeSkillstheir own version, first seen Sep 14, 2026
- NaveenGumaste/keyskillstheir own version, first seen Sep 11, 2026
- mangollc/claude-seo-skilltheir own version, first seen Feb 19, 2026
Other versions4 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 4
- mangollc/claude-seo-skill★ 39same name
- NaveenGumaste/keyskills★ 2same name
- BreRoz/ClaudeSkills★ 0same name
- Solnest-AI/solnest-seo-aeo★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository27 other files it gives its agents.
- llms.txtllms.txt
- ai-search-researchSkill
- ai-visibility-monitorSkill
- optimise-seoSkill
- seo-action-planSkill
- seo-agenticSkill
- seo-architectureSkill
- seo-auditSkill
- seo-authoritySkill
- seo-commerceSkill
- seo-competitor-pagesSkill
- seo-contentSkill
- seo-geoSkill
- seo-hreflangSkill
- seo-imagesSkill
- seo-localSkill
- seo-news-discoverSkill
- seo-pageSkill
- seo-performanceSkill
- seo-planSkill
- seo-programmaticSkill
- seo-researchSkill
- seo-schemaSkill
- seo-sitemapSkill
- seoSkill
- seo-technicalSkill
- seo-videoSkill
The file
We split this skill into the rules it gives an agent
6 rules. 0 are common, 3 are distinctive, and 3 are very specific to this project.
0
Common
Most of the 4 edited versions we read keep these.
3
Distinctive
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 10
Read markdown-delivery-contract.md for every task.
- Distinctive: line 22
Read audit-protocol.md before scoring findings or recommending a handoff.
- Distinctive: line 26
Verify the Research Pack identity, schema version, hash, declared locales, queries, evidence, ground truth, and gaps.
- Distinctive: line 27
Verify every target capture, capture time, target type, and locale.
- Very specific: line 39
Create an optimization-brief.json with optimization_domain: "aeo" and producer_skill: "seo-aeo".
- Very specific: line 55
Do not perform GEO mention/citation strategy.
“Common” is measured: kept by at least 6 in 10 of the 4 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
SEO AEO
Markdown delivery contract
Read markdown-delivery-contract.md for every task. Write a substantive .md document for every material work step and register its direct destination in the work index.md. For public-site work, apply the owner-required Markdown discovery profile across the full eligible inventory; preserve native standards and immutable evidence formats.
Lane outputs: aeo-findings.md; answer-map.md (combine small related steps with stable section links). Audit substantive Markdown answers alongside their pinned HTML/source captures: self-contained meaning, question-to-section access, completeness, dates, limitations and HTML parity. Keep formal Research Pack requirements for engine-scoped claims. Route publisher navigation/parity defects to technical/content owners without inventing engine evidence.
Produce an evidence-linked AEO Optimization Brief from immutable inputs. Audit answer readiness; do not implement the remedies.
Required inputs
- Require a contract-valid
research-pack.jsonfromai-search-research. - Require a dated, bundle-relative capture plus a hash-pinned target-metadata file containing target ID, type, locale, supplied source URL, capture reference, capture SHA-256, and capture time. Never trust Brief fields without matching metadata, invent a canonical URL, or audit an uncaptured, unpinned, or silently refreshed page.
- Record inaccessible, incomplete, stale, or locale-mismatched inputs as limitations. Do not infer missing content.
- Read audit-protocol.md before scoring findings or recommending a handoff.
Procedure
- Verify the Research Pack identity, schema version, hash, declared locales, queries, evidence, ground truth, and gaps.
- Verify every target capture, capture time, target type, and locale. Stop with an explicit gap if a required capture is missing.
- Audit only these AEO dimensions:
- direct-answer completeness;
- question, intent, audience, and journey-stage coverage;
- answer clarity and self-contained meaning;
- claim-to-evidence support and freshness;
- entity and terminology consistency within the answer;
- visible-content consistency with any supplied structured-data representation.
- Verify every Brief target field against the hash-pinned metadata file. Record target observations as intra-brief
direct_observationevidence pinned to the target capture and metadata-supplied source URL. Do not invent a URL or republish Research Pack source records as audit evidence. A target finding must cite that observation; research-dependent conclusions must also cite scope-matched Research Pack evidence. - Bind each finding to resolved Research Pack query IDs. Keep the finding locale equal to its target locale and keep engine/surface scope within those queries' applicability.
- Classify each observation as
confirmed,vendor-recommended,experimental, orspeculative. A finding or confidence level cannot exceed its weakest necessary premise. Speculative evidence never supports an implementation recommendation. Experimental-only support belongs inexperiments; route unsupported premises to limitations, declined claims, or research backlog. - Reject unsupported formulas, word-count thresholds, guaranteed placements, universal crawler claims, and universal engine-mandatory
llms.txtclaims intodeclined_claims. - Create an
optimization-brief.jsonwithoptimization_domain: "aeo"andproducer_skill: "seo-aeo". Pin every external evidence reference to the immutable Research Pack hash. UseSELFonly for an intra-briefaudit_evidencereference. Keep stable IDs unique and never copy Research Pack evidence intoaudit_evidence. - Give every recommendation its own evidence references, desired outcome, confidence, verification method, and exactly one candidate implementation owner. Its evidence must overlap every linked finding and remain scope-compatible. A Brief does not approve a change.
- Set
created_atafter all target captures and audit observations. Validate Research Pack uniqueness, chronology, capture hashes, query applicability, evidence resolution and scope, and the Optimization Brief contract before delivery.
Ownership boundaries
Route implementation planning first; never perform or approve implementation inside this skill:
seo-action-plan: evidence-linked ownership, approval gate, verification, and rollback for a validated Brief.seo-content: substantive wording, editorial quality, or answer rewrite.seo-schema: structured-data choice, generation, syntax, eligibility, or validation.seo-technical: crawlability, rendering, indexing, directives, performance, or transport controls.seo-hreflang: locale and regional mapping.optimise-seo: broader integrated page optimization outside the AEO delta.
Do not perform GEO mention/citation strategy; route that to seo-geo. Do not measure live visibility or drift; route that to ai-visibility-monitor. Do not create missing research; route that to ai-search-research.
Severity and review
critical: the audit or handoff would be materially false, unsafe, or unusable without correction.important: a required answer, evidence link, locale, or owner handoff is missing or misleading.minor: non-blocking clarity or maintainability improvement; record it in backlog.
Close all critical and important audit findings. Backlog minor findings.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

