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".
99
100%
Does it follow best practices?
Impact
99%
1.30xAverage score across 3 eval scenarios
Advisory
Suggest reviewing before use
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an excellent skill description that hits all the marks. It provides specific concrete actions, includes a comprehensive 'Use when' clause with natural trigger phrases, and carves out a distinct niche around AEO/GEO optimization that won't conflict with other skills. The description uses proper third-person voice throughout.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific 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', 'work through a full 29-item AEO/GEO checklist'. | 3 / 3 |
Completeness | Clearly answers both what (AEO/GEO agent for documentation sites with specific capabilities) AND when (explicit 'Use when' clause with multiple trigger scenarios and example phrases). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'optimize my docs for AI', 'make my site discoverable by AI', 'AEO audit', 'GEO optimization', 'help me rank in AI search results', plus technical terms like 'llms.txt' and 'structured data'. | 3 / 3 |
Distinctiveness Conflict Risk | Very clear niche focusing specifically on AEO/GEO for documentation sites with distinct terminology (llms.txt, 29-item checklist, AI citation) that is unlikely to conflict with general SEO or documentation skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is an exemplary skill file that demonstrates best practices across all dimensions. It provides a clear five-phase workflow with explicit checkpoints, concrete executable commands, efficient use of tables for reference data, and well-organized progressive disclosure to subagents and reference files. The human-in-the-loop design with explicit checkpoint dialogues shows sophisticated workflow thinking.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is highly efficient with no unnecessary explanations. It assumes Claude's competence, uses tables for dense information, and every section serves a clear purpose without padding or explaining basic concepts. | 3 / 3 |
Actionability | Provides fully executable bash commands, specific file paths, clear delegation routing tables, and exact checkpoint dialogue templates. The workflow is copy-paste ready with concrete scripts and output locations. | 3 / 3 |
Workflow Clarity | Excellent five-phase workflow with explicit validation checkpoints after each execution item. Includes clear feedback loops (approve/request changes/skip/stop), dependency ordering, and a verification phase that compares baseline to final state. | 3 / 3 |
Progressive Disclosure | Well-structured with clear overview, references to subagent files (agents/assessor.md, planner.md, executor.md, verifier.md), custom subskills, and a 'load on-demand' reference table. Navigation is one level deep and clearly signaled. | 3 / 3 |
Total | 12 / 12 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 — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- kubical-ai/aeo-geo-optimization
- Commit
658c481
- 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.