CtrlK
BlogDocsLog inGet started
Tessl Logo

ai-seo

Optimize content for AI search and LLM citations across AI Overviews, ChatGPT, Perplexity, Claude, Gemini, and similar systems. Use when improving AI visibility, answer engine optimization, or citation readiness.

65

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills/skills/ai-seo/SKILL.md

The canonical home for this skill is ai-seo in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

67%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, actionable reference for AI-search optimization with a clear audit workflow and verified external references. Its main weaknesses are length/padding, time-sensitive statistics that will date, and a large inlined body that could push more detail into reference files.

Suggestions

Move time-sensitive statistics (the 45%/58%/6.5x/3x figures and the Princeton GEO boost table) into references/ or a dated 'Current data' section so the main body stays evergreen.

Trim the 'You are an expert in AI search optimization...' role preamble and other explanatory prose to tighten the token budget.

Externalize the schema-markup catalog and monitoring-tools tables into a reference file to reduce inlined bulk and deepen progressive disclosure.

DimensionReasoningScore

Conciseness

Mostly information-dense via tables, but the ~400-line body carries padding (the "You are an expert in AI search optimization" role preamble) and time-sensitive statistics ("AI Overviews appear in ~45% of Google searches", "6.5x more likely") that will date and are not isolated in a deprecated/old-patterns section, matching 'mostly efficient but includes some unnecessary explanation'.

3 / 5

Actionability

Concrete and specific for an instruction skill — named content block patterns, schema types (Article/HowTo/FAQPage/Product), structural rules ("40-60 words", "Lead every section with a direct answer"), named bots (GPTBot, PerplexityBot), and named monitoring tools — with only minor abstract bits like "Improve readability and flow".

4 / 5

Workflow Clarity

The AI Visibility Audit is a clearly sequenced 4-step process whose Step 3 includes a Pass/Fail extractability checklist acting as a validation checkpoint, but there is no explicit fix-and-re-check feedback loop, matching 'clear sequence with most checkpoints present; minor validation gaps'. The destructive/batch cap does not apply since this is advisory content.

4 / 5

Progressive Disclosure

SKILL.md acts as an overview with two real, well-signaled, one-level-deep references (references/platform-ranking-factors.md and references/content-patterns.md, both verified present), but a body this large keeps dense tabular material (Princeton GEO methods, schema catalog, monitoring tools, content-type shares) inlined that could be split out, matching 'good structure; most content appropriately placed; minor organization gaps'.

4 / 5

Total

15

/

20

Passed

Description

90%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, concise, with explicit what/when structure and rich natural trigger terms including synonyms and platform names. The only weakness is that it names one broad action (optimize) rather than enumerating several distinct capabilities.

DimensionReasoningScore

Specificity

It names the domain and the core action ("Optimize content for AI search and LLM citations") but uses a single verb across platforms rather than listing several distinct concrete actions, matching the 'names domain and 1-2 concrete actions' anchor and falling short of the multi-action score-4 example.

3 / 5

Completeness

Explicitly answers both what ("Optimize content for AI search and LLM citations across [platforms]") and when ("Use when improving AI visibility, answer engine optimization, or citation readiness") with concrete trigger phrases, matching the score-5 anchor.

5 / 5

Trigger Term Quality

Comprehensive natural-term coverage including synonyms users actually say — "AI search", "LLM citations", "AI visibility", "answer engine optimization", "citation readiness" — plus named platforms (AI Overviews, ChatGPT, Perplexity, Claude, Gemini), matching the comprehensive-synonyms anchor.

5 / 5

Distinctiveness Conflict Risk

Carves a clear niche (AI-specific citation/AEO optimization) with distinct triggers unlikely to fire for adjacent traditional-SEO skills, matching the 'clear niche with distinct triggers; minimal conflict risk' anchor.

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
administrakt0r/AI-Agents-Safe-Coding-Skills
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.