AI Engine Optimization - semantic triples, page templates, content clusters for AI citations
33
30%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/aeo-optimization/SKILL.mdQuality
Discovery
32%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description identifies a specific niche (AI Engine Optimization) and lists relevant technical concepts, which gives it some distinctiveness. However, it lacks action verbs describing what the skill does, omits a 'Use when...' clause entirely, and reads more like a tag list than a functional description. It would be difficult for Claude to confidently select this skill from a large pool based on this description alone.
Suggestions
Add explicit action verbs describing what the skill does, e.g., 'Generates semantic triples, creates page templates, and organizes content clusters to optimize web pages for AI engine citations.'
Include a 'Use when...' clause with natural trigger terms, e.g., 'Use when the user wants to optimize content for AI search engines, improve AI citations, or structure pages for LLM discoverability.'
Add common user-facing synonyms and variations such as 'AEO', 'AI SEO', 'optimize for ChatGPT/Perplexity', 'get cited by AI' to improve trigger term coverage.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names a domain ('AI Engine Optimization') and lists some specific concepts ('semantic triples, page templates, content clusters for AI citations'), but these read more like a keyword list than concrete actions. No verbs describe what the skill actually does (e.g., 'generates', 'creates', 'optimizes'). | 2 / 3 |
Completeness | The description partially addresses 'what' (AI Engine Optimization involving semantic triples, page templates, content clusters) but has no 'when' clause or explicit trigger guidance. Per the rubric, a missing 'Use when...' clause caps completeness at 2, and the 'what' itself is weak enough (no verbs, no clear actions) to warrant a 1. | 1 / 3 |
Trigger Term Quality | Terms like 'semantic triples', 'content clusters', and 'AI citations' are relevant to the domain but fairly technical. Common user phrasings like 'optimize for AI search', 'get cited by AI', 'AEO', or 'AI SEO' are missing, reducing natural trigger coverage. | 2 / 3 |
Distinctiveness Conflict Risk | The niche of AI Engine Optimization is relatively distinct from general SEO or content writing skills, but the lack of explicit scoping means it could overlap with general content strategy or SEO skills. The term 'content clusters' in particular is used broadly in SEO contexts. | 2 / 3 |
Total | 7 / 12 Passed |
Implementation
27%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill contains genuinely useful AEO content — the semantic triples concept, paragraph patterns, page templates, and checklists are valuable. However, it is far too verbose for a skill file, spending significant tokens on marketing context and conceptual explanations Claude doesn't need. The monolithic structure with five full templates inline makes it a wall of text that would benefit enormously from splitting into a concise overview with references to template files.
Suggestions
Cut the 'Why AEO Matters Now' section (stats, ASCII art box), 'AEO vs Traditional SEO' table, and 'How AI Engines Choose Answers' conceptual explanations — Claude already understands these marketing concepts.
Move the five page templates into separate referenced files (e.g., templates/category-explainer.md, templates/product-page.md) and keep only a brief summary table in SKILL.md linking to each.
Add an explicit numbered workflow: e.g., 1) Identify content type needed, 2) Select template, 3) Write using triple pattern, 4) Run per-page checklist, 5) Validate cluster links.
Move the schema markup examples and measurement/tools sections into separate reference files to reduce the main skill to under 100 lines.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose at ~400+ lines, with significant padding that Claude doesn't need. The 'Why AEO Matters Now' section with ASCII art box, key stats, the 'How AI Engines Choose Answers' conceptual explanation, and the 'AEO vs Traditional SEO' comparison table all explain marketing concepts Claude already understands. The five full page templates are highly repetitive in structure and could be condensed dramatically. | 1 / 3 |
Actionability | The templates provide concrete structural patterns and the schema markup examples are copy-paste ready HTML. However, much of the content is fill-in-the-bracket templates rather than executable code/commands, and the guidance is more about content strategy principles than specific executable steps. The semantic triple examples and paragraph patterns are concrete and useful. | 2 / 3 |
Workflow Clarity | The checklists (per-paragraph, per-section, per-page, site-wide) provide a clear sequence of validation steps, and the content cluster architecture shows a clear hierarchy. However, there's no explicit workflow for creating AEO content from start to finish — no numbered process with validation checkpoints. The skill presents components but doesn't sequence them into a clear 'do this, then validate, then proceed' workflow. | 2 / 3 |
Progressive Disclosure | All content is monolithically packed into a single massive file with no references to supporting files. The five full page templates, schema examples, comparison tables, and measurement guidance could easily be split into separate reference files. There's no bundle structure to support progressive disclosure, and the SKILL.md tries to be both overview and complete reference simultaneously. | 1 / 3 |
Total | 6 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
skill_md_line_count | SKILL.md is long (556 lines); consider splitting into references/ and linking | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 9 / 11 Passed | |
65efb33
Table of Contents
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.