CtrlK
BlogDocsLog inGet started
Tessl Logo

aeo-optimization

AI Engine Optimization - semantic triples, page templates, content clusters for AI citations

33

Quality

30%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/aeo-optimization/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

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

Repository
alinaqi/claude-bootstrap
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.