CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

aeo

Answer Engine Optimization (AEO) skill — optimize content to be cited by AI language models (ChatGPT, Perplexity, Claude, Gemini, Mistral) as authoritative sources. Distinct from SEO — AEO optimizes for citation in LLM-generated responses, not search rankings. Use when planning content for AI-first search audiences, auditing existing content for E-E-A-T signals, tracking which pages get cited by which LLMs, or building a citation-friendly content strategy. Triggers — 'AEO audit', 'optimize for ChatGPT', 'get cited by Perplexity', 'LLM citation strategy', 'answer engine optimization', 'content for AI search', 'E-E-A-T audit'. Output is a markdown audit report (default) or JSON for pipeline integration. Stdlib-only Python tools.

65

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

The canonical home for this skill is aeo in alirezarezvani/claude-skills

SKILL.md
Quality
Evals
Security

Quality

Content

71%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-organized, largely lean body with concrete CLI commands, an explicit pre-flight gate, and valuable domain-specific tables (industry thresholds, anti-patterns). The main defect is bundle integrity: every referenced reference/ and scripts/ path is missing from the bundle, so the skill's navigation and commands cannot actually be followed as shipped.

Suggestions

Ship the bundle: include the five references/*.md files and the three scripts/*.py files that the body cites — the References section and every workflow command currently point at files that do not exist in the bundle.

Move the 'Industry-Specific E-E-A-T Thresholds' table and the 'Anti-Patterns Rejected' section into references/aeo_eeat_canon.md (which already advertises 'industry thresholds, anti-patterns') and keep only a one-line pointer plus the two or three most common industries inline.

Add an explicit validation step to the workflow, e.g., after optimization: review the optimizer diff and re-run aeo_audit.py on the optimized variant to confirm the composite score improved before publishing.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious domain specifics (E-E-A-T dimension definitions, per-industry threshold table, citation-ledger CLI usage, anti-pattern list) that Claude would not already know, so most tokens earn their place. It sits at the 4 anchor rather than 5 due to minor trim candidates: the 'Trigger Phrases' section duplicates the frontmatter description, the 'Both can coexist...' prose under 'Distinct From SEO' explains concepts Claude already knows (SEO rewards backlinks/keywords), and the version/source footer adds metadata tokens; it is above the 3 anchor because there is no substantial padded explanation.

4 / 5

Actionability

Quotes: '$ python3 scripts/aeo_audit.py --url https://example.com/blog/post', '$ python3 scripts/aeo_optimizer.py --input post.md --mode balanced --output post-aeo.md', 'python3 scripts/aeo_audit.py --url <url> --industry healthcare', and tracker add/report invocations — concrete, flag-level commands for the common cases, plus a full example output report. This matches the 4 anchor ('concrete code or commands with minor gaps') rather than 5 because the optimizer's output is never exemplified, the 'query_research mode' is mentioned only as scaffold-only with no usage, and the audit report example contains '[...]' placeholders.

4 / 5

Workflow Clarity

The numbered 0-4 workflow is clearly sequenced with a real command and expected output ('→ markdown report with composite score + 4-dimension breakdown') per step, and step 0 is an explicit gating pre-check ('a blocked GPTBot/PerplexityBot/ClaudeBot/Google-Extended is the first fix, always'). This matches the 4 anchor; it is not 5 because there is no explicit validation or error-recovery step (e.g., reviewing the optimizer diff before publishing, or what to do when the audit scores below an industry threshold), and it is above the 3 anchor because checkpoints are not merely implicit — the pre-flight gate and per-step expected outputs are stated.

4 / 5

Progressive Disclosure

References are clearly signaled with one-line descriptions ('references/aeo_eeat_canon.md — E-E-A-T methodology, industry thresholds, anti-patterns') and are one level deep, but none of the referenced files exist in the bundle — there are no references/, scripts/, or assets/ directories, so all 5 reference paths and all 3 script paths are dangling. Additionally, content that the reference descriptions say lives in those files (the industry-threshold table duplicating 'aeo_eeat_canon.md' territory, and the Anti-Patterns section overlapping the canon's 'anti-patterns') is inlined in the body. Good signaling but broken navigation and duplicated placement matches the 3 anchor ('structure present but content that should be separate is inline / references do not resolve); it is above 2 because the body itself is well sectioned and not an unstructured monolith, and below 4 because referenced paths do not resolve to real files.

3 / 5

Total

15

/

20

Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: third-person voice, explicit what/when, concrete output format, and an explicit SEO boundary with natural trigger phrases. Only minor gaps — 'strategy'/'optimize' phrasing is somewhat abstract and a couple of common synonyms (GEO, AI SEO) are absent.

DimensionReasoningScore

Specificity

Quotes: 'optimize content to be cited by AI language models', 'auditing existing content for E-E-A-T signals', 'tracking which pages get cited by which LLMs', 'Output is a markdown audit report (default) or JSON for pipeline integration'. Several concrete, distinct actions are named with a concrete output format, matching the 'several specific actions; minor gaps' anchor; it falls short of the 5 anchor because 'building a citation-friendly content strategy' and 'optimize content' remain moderately abstract, and it is above the 3 anchor because more than 1-2 actions are covered.

4 / 5

Completeness

Quotes: what — 'optimize content to be cited by AI language models... as authoritative sources... audits, optimizes, and tracks' (implied by the action list) plus explicit output format; when — 'Use when planning content for AI-first search audiences, auditing existing content for E-E-A-T signals, tracking which pages get cited by which LLMs, or building a citation-friendly content strategy' followed by explicit trigger phrases. Both what and when are explicitly and concretely answered, matching the 5 anchor exactly; the 4 anchor's 'when could be more explicit' does not apply.

5 / 5

Trigger Term Quality

Quotes: 'AEO audit', 'optimize for ChatGPT', 'get cited by Perplexity', 'LLM citation strategy', 'answer engine optimization', 'content for AI search', 'E-E-A-T audit' — plus when-clauses like 'tracking which pages get cited by which LLMs'. Good, natural keyword coverage with several phrasings users would actually say; not the 5 anchor because common synonyms such as 'generative engine optimization' / 'GEO' and 'AI SEO' are missing.

4 / 5

Distinctiveness Conflict Risk

Quotes: 'Distinct from SEO — AEO optimizes for citation in LLM-generated responses, not search rankings'. The description explicitly draws the boundary against the closest adjacent skill (SEO) and uses niche-specific triggers ('AEO audit', 'get cited by Perplexity', 'E-E-A-T audit') that no generic skill would claim, matching the 'clear niche with distinct triggers; minimal conflict risk' anchor rather than the 4 anchor, which requires residual overlap with closely related skills.

5 / 5

Total

18

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 12 missing

Warning

Total

15

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

.gemini/skills/aeo/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.