CtrlK
BlogDocsLog inGet started
Tessl Logo

seo-aeo-best-practices

SEO and AEO best practices for metadata, Open Graph, sitemaps, robots.txt, hreflang, JSON-LD structured data, EEAT, and content optimized for search engines and AI answer surfaces. Use this skill when implementing page SEO, technical SEO, schema markup, international SEO, AI-overview readiness, or improving content for Google, ChatGPT, Perplexity, and similar assistants.

64

Quality

80%

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 ./skills/seo-aeo-best-practices/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is a well-organized index that exemplifies progressive disclosure, but it is held back by over-explanation of well-known concepts and a lack of any concrete actionable guidance in the body itself.

Suggestions

Remove or collapse the 'Core Concepts' section — Claude already knows what SEO, AEO, and EEAT are — to tighten conciseness.

Add at least one concrete inline snippet (e.g., a minimal JSON-LD block or a robots.txt/sitemap skeleton) so the body is actionable on its own, not purely a pointer to references.

Tighten the 'When to Apply' list to avoid duplicating the description's trigger clause, or map each bullet directly to the specific reference file that covers it.

DimensionReasoningScore

Conciseness

The body is mostly lean, but the 'Core Concepts' section re-defines SEO, AEO, and EEAT — concepts Claude already knows — and the 'When to Apply' list duplicates the description's trigger clauses, so it could be tightened.

3 / 5

Actionability

The body provides no concrete code, commands, or implementation steps; it only describes and navigates ('See references/ for detailed guidance'), leaving the actual actionable detail entirely to the reference files.

2 / 5

Workflow Clarity

As a simple index skill the single action (consult the matching reference) is clearly stated ('Start with the one reference that matches the task'), but the 'When to Apply' bullets do not map one-to-one onto the four reference files, leaving a minor gap.

4 / 5

Progressive Disclosure

A clean overview body points to four one-level-deep reference files, each with a clear one-line description and verified to exist in references/, making navigation easy and well-signaled.

5 / 5

Total

14

/

20

Passed

Description

95%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, well-structured description that clearly states what the skill covers and when to use it, with rich natural trigger terms and a distinct niche. The only minor weakness is that the 'what' leans on a topic list rather than explicit concrete actions.

DimensionReasoningScore

Specificity

Lists several concrete domains (metadata, Open Graph, sitemaps, robots.txt, hreflang, JSON-LD, EEAT) with action verbs in the trigger clause, but the 'what' reads as a topic list rather than a list of concrete actions, keeping it just below a 5.

4 / 5

Completeness

Explicitly answers both 'what' ('SEO and AEO best practices for...') and 'when' ('Use this skill when implementing page SEO, technical SEO, schema markup, international SEO, AI-overview readiness, or improving content for...'), with concrete trigger phrases.

5 / 5

Trigger Term Quality

Comprehensive natural-term coverage including synonyms (SEO/AEO, 'search engines'/'AI answer surfaces') and product names users actually say (Google, ChatGPT, Perplexity), plus technical terms like hreflang and JSON-LD.

5 / 5

Distinctiveness Conflict Risk

Occupies a clear SEO/AEO niche with distinct triggers (schema markup, hreflang, AI-overview readiness) and minimal overlap risk with unrelated skills.

5 / 5

Total

19

/

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
sanity-io/agent-toolkit
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.