CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

aeo-geo-agent

End-to-end AEO (Answer Engine Optimization) and GEO (Generative Engine Optimization) agent for documentation sites. Use when someone wants to optimize their docs for AI citation, improve AI discoverability, audit their site against AEO best practices, create llms.txt, add AI-friendly structured data, or work through a full 29-item AEO/GEO checklist. Also use for phrases like "optimize my docs for AI", "make my site discoverable by AI", "AEO audit", "GEO optimization", or "help me rank in AI search results".

89

1.30x
Quality

87%

Does it follow best practices?

Impact

99%

1.30x

Average score across 3 eval scenarios

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

70%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-structured, token-efficient orchestration body with excellent phase sequencing, checkpoints, feedback loops, and verification. Its central weakness is that the bundle is incomplete: Phases 3–5 and the delegation routing all point to agents/ and skills/ files that are absent, so the skill's core execution guidance is unavailable as shipped.

Suggestions

Ship the referenced agents/ files (assessor.md, planner.md, executor.md, verifier.md) and the three skills/ subskill SKILL.md files in the bundle — or inline their essential instructions into SKILL.md — since Phases 3–5 and the routing table currently defer to files that do not exist.

Remove or shrink the 29-row Item Reference table at the end of the body; references/checklist.md is already designated the 'master reference for all 29 items', so the duplication costs tokens without adding navigation value (keep only the Impact/Time summary needed for Phase 2 batching).

Fix the 'Custom Subskills' section to match reality: either provide skills/llms-txt-creator, skills/ai-prompt-files, and skills/ai-discoverability, or remove the section and the routing-table rows ('custom: ...') that point to them.

DimensionReasoningScore

Conciseness

The body is lean and imperative — no padding explaining what AEO/llms.txt is, phases are compressed into tables, and commands are inline — matching 'Efficient; minor instances of over-explanation that could be trimmed'. The main trim target is the 29-row Item Reference table, which duplicates the item names/impact/time already in references/checklist.md that the body itself calls 'your master reference for all 29 items'. Not score 5 because that duplicated table is ~15% of the body that earns its place only partially (Impact/Time columns do support Phase 2 batching); not score 3 because there is no unnecessary concept explanation or fluff.

4 / 5

Actionability

Phase 1 is copy-paste executable ('python3 scripts/assess_project.py --project-root <path> --output /tmp/aeo-assessment.json'), and the multi-select option format ('#N — Item Name (⏱ time estimate)') and routing table are concrete. But Phases 3–5 defer their actual instructions to 'the planner subagent instructions in agents/planner.md', 'agents/executor.md', 'agents/verifier.md', and the skills/ subskills — none of which exist in the bundle — so the executor has no real guidance for the core plan/execute/verify work. This matches 'Some concrete guidance but incomplete... missing key details'; not score 4 because the missing files are not a minor gap but the substance of three phases.

3 / 5

Workflow Clarity

The five phases are clearly sequenced with per-phase goals, a dependency map ('#2 requires #1... Execute in dependency order automatically'), an explicit per-item checkpoint with feedback loop ('Response (b): loop executor with feedback, re-implement, re-checkpoint'), and a verification phase that re-runs the scanner against a saved baseline ('Save the assessment JSON to /tmp/aeo-assessment-baseline.json for later comparison'). This matches 'Clear sequence with explicit validation steps; feedback loops for error recovery; checklists for complex processes'; the destructive/batch-operation cap does not apply since validation checkpoints are present.

5 / 5

Progressive Disclosure

The reference table is well-signaled with a 'Load When' column and an explicit on-demand instruction ('Load on-demand as needed (don't pre-load all)'), and references/ and scripts/ files all exist. However, scoring against the actual bundle: the 7 referenced paths that carry the workflow's core content — agents/assessor.md, agents/planner.md, agents/executor.md, agents/verifier.md, and the three skills/*/SKILL.md subskills ('The three custom subskills in skills/') — do not exist, so navigation dead-ends in 4 of the 5 phases. This sits between 'references present but not clearly signaled' (3, wrong reason — signaling is good) and 'references mostly clear; minor organization gaps' (4, too generous for a third of the navigation being broken); 3 is the best fit for structure that does not hold against the real bundle.

3 / 5

Total

15

/

20

Passed

Description

100%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.

An exemplary description: third-person statement of concrete capabilities, an explicit 'Use when' clause, and a second sentence of verbatim natural-language trigger phrases with acronyms expanded. Both 'what' and 'when' are fully explicit with comprehensive, distinctive trigger coverage.

DimensionReasoningScore

Specificity

The description lists six concrete actions — "optimize their docs for AI citation, improve AI discoverability, audit their site against AEO best practices, create llms.txt, add AI-friendly structured data, or work through a full 29-item AEO/GEO checklist" — covering assessment, implementation, and the checklist breadth comprehensively. It matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage'; score 4 would require minor coverage gaps, and the '29-item checklist' phrase subsumes the remaining scope (MCP server, backlinks, i18n).

5 / 5

Completeness

Both questions are answered explicitly: what ("End-to-end AEO... and GEO... agent for documentation sites" with the action list) and when ("Use when someone wants to..." plus "Also use for phrases like..."). This is a direct match for the top anchor 'Clearly and explicitly answers both what AND when with concrete trigger phrases'; score 4 would require the 'when' to be less explicit or specific, which it is not.

5 / 5

Trigger Term Quality

It explicitly quotes natural user phrases — "optimize my docs for AI", "make my site discoverable by AI", "AEO audit", "GEO optimization", "help me rank in AI search results" — plus domain keywords and acronyms spelled out ("AEO (Answer Engine Optimization)", "GEO (Generative Engine Optimization)", llms.txt). This meets 'Comprehensive coverage of natural terms including synonyms'; score 4 would need clearly missing natural terms, and none of the common phrasings for this domain are absent.

5 / 5

Distinctiveness Conflict Risk

The niche is clear — AI citation/AEO/GEO optimization for documentation sites — with highly distinctive triggers (llms.txt, AI citation, AEO audit, AI discoverability) unlikely to fire for unrelated skills. Generic SEO requests ("improve my SEO") are not listed as triggers, so conflict risk is minimal per the anchor 'Clear niche with distinct triggers'; score 4's 'minor overlap risk with closely related skills' would apply only if a trigger plausibly matched another skill's domain, which the niche terminology avoids.

5 / 5

Total

20

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

kubical-ai/aeo-geo-optimization

Path

claude-code/skills/aeo-geo-agent/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.