When the user needs a technical SEO audit, on-page optimization guidance, or help resolving crawlability, indexation, or performance issues that affect search rankings.
68
61%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/seo-technical/SKILL.mdQuality
Discovery
72%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 effectively identifies when the skill should be triggered with good natural keywords in the SEO domain, and it occupies a clear niche. However, it lacks explicit concrete actions (the 'what') — it tells Claude when to use the skill but doesn't clearly enumerate what specific capabilities the skill provides, such as generating sitemaps, auditing meta tags, or analyzing page speed.
Suggestions
Add explicit capability statements listing concrete actions, e.g., 'Performs technical SEO audits, analyzes robots.txt and sitemaps, checks meta tags, evaluates page speed, and identifies crawl errors.'
Separate the 'what it does' from the 'when to use it' — start with concrete actions, then follow with 'Use when the user needs a technical SEO audit, on-page optimization guidance, or help resolving crawlability issues.'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (technical SEO) and mentions several areas like 'crawlability, indexation, or performance issues,' but it describes categories of work rather than listing multiple specific concrete actions (e.g., 'generate XML sitemaps, analyze robots.txt, audit meta tags, check page speed'). | 2 / 3 |
Completeness | The description is framed as a 'when' clause ('When the user needs...'), which addresses when to use the skill, but the 'what does this do' is only implied through the trigger conditions rather than explicitly stated as concrete capabilities. The what and when are conflated rather than clearly separated. | 2 / 3 |
Trigger Term Quality | Includes strong natural keywords users would say: 'SEO audit,' 'on-page optimization,' 'crawlability,' 'indexation,' 'performance issues,' and 'search rankings.' These cover a good range of terms a user seeking SEO help would naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | Technical SEO is a clear niche with distinct trigger terms like 'SEO audit,' 'crawlability,' 'indexation,' and 'on-page optimization' that are unlikely to conflict with other skills. | 3 / 3 |
Total | 10 / 12 Passed |
Implementation
50%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-organized technical SEO audit skill with good domain coverage across 9 dimensions and clear prioritization in the output format. Its main weaknesses are the lack of executable examples (no code snippets for schema markup, robots.txt configurations, or validation commands) and missing validation/feedback loops in the workflow. The content is moderately verbose with some explanations Claude wouldn't need, and the monolithic structure would benefit from splitting detailed audit checklists into referenced files.
Suggestions
Add concrete, copy-paste-ready examples: a robots.txt template with AI crawler rules, a JSON-LD schema markup snippet for Organization/Article, and example sitemap XML structure.
Add explicit validation checkpoints to the workflow: e.g., 'After fixing crawlability issues, re-run site:domain.com check and verify Search Console index coverage before proceeding to next dimension.'
Split the 9 detailed audit dimensions into a separate AUDIT-CHECKLIST.md file, keeping SKILL.md as a concise overview with the workflow structure and references.
Remove explanatory phrases Claude already knows (e.g., 'HTTPS is a ranking signal and a trust requirement', 'Short, descriptive, hyphenated URLs without parameters') and replace with just the actionable checks.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is fairly comprehensive but includes some unnecessary explanation that Claude would already know (e.g., explaining what HTTPS is, what canonical tags are, what mixed content means). Some bullet points could be tightened—for instance, the Core Web Vitals section explains what LCP/INP/CLS are rather than just stating targets and fixes. However, it's not egregiously verbose and most content is informational rather than padded. | 2 / 3 |
Actionability | The skill provides structured checklists and specific metrics targets (LCP < 2.5s, INP < 200ms, CLS < 0.1), which is good. However, it lacks executable code/commands—no actual robots.txt examples, no schema markup JSON-LD snippets, no command-line tools for validation, no concrete Search Console API queries. The guidance is specific in what to check but not copy-paste ready for implementation. | 2 / 3 |
Workflow Clarity | The 9-dimension audit workflow is clearly sequenced and logically ordered (crawlability first, then indexation, etc.). The output format includes prioritization tiers. However, there are no explicit validation checkpoints or feedback loops—no 'verify fix worked' steps, no 're-check after implementing changes' guidance, and no error recovery paths within the audit process itself. | 2 / 3 |
Progressive Disclosure | The content is well-structured with clear sections (When to Use, Context Required, Workflow, Output Format, Frameworks, Examples), and references related skills at the end. However, the main body is quite long (~120+ lines of dense content) and could benefit from splitting detailed dimension audits into separate reference files, keeping SKILL.md as an overview with links to detailed checklists per dimension. | 2 / 3 |
Total | 8 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
4ad31b4
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.