Run a comprehensive technical SEO audit covering crawlability, indexability, rendering, site architecture, structured data, page experience, security, and internationalization. Use this skill whenever the user asks about technical SEO, crawl issues, indexing problems, sitemaps, robots.txt, canonical tags, schema markup, page speed, Core Web Vitals, hreflang, redirects, or site-wide search performance. Triggers on technical SEO, site audit, crawlability, indexability, sitemap, robots.txt, canonical, redirect chain, schema, JSON-LD, Core Web Vitals, page speed, hreflang, mobile usability, HTTPS, security headers, render-blocking, JavaScript SEO. Also triggers when a site has indexing problems, traffic drops, or migration concerns, even if 'technical SEO' is not said explicitly.
63
75%
Does it follow best practices?
Impact
—
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
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an excellent skill description that thoroughly covers what the skill does, when to use it, and includes comprehensive trigger terms. It uses proper third-person voice, lists concrete audit areas, and even accounts for implicit triggers (e.g., traffic drops, migration concerns). The only minor concern is slight verbosity with some redundancy between the 'Use this skill whenever' clause and the 'Triggers on' list, but this doesn't detract from its effectiveness.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions and domains: crawlability, indexability, rendering, site architecture, structured data, page experience, security, and internationalization. The description clearly names what the audit covers. | 3 / 3 |
Completeness | Clearly answers both 'what' (run a comprehensive technical SEO audit covering specific areas) and 'when' (explicit 'Use this skill whenever...' clause plus a 'Triggers on' list and even implicit trigger scenarios like traffic drops). Both dimensions are thoroughly addressed. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms users would say: 'technical SEO', 'crawl issues', 'indexing problems', 'sitemaps', 'robots.txt', 'canonical tags', 'schema markup', 'page speed', 'Core Web Vitals', 'hreflang', 'redirects', 'traffic drops', 'migration concerns'. These are highly natural terms that match real user queries. | 3 / 3 |
Distinctiveness Conflict Risk | The skill occupies a clear niche—technical SEO auditing—with highly specific trigger terms like 'robots.txt', 'canonical tags', 'hreflang', 'JSON-LD', and 'redirect chain' that are unlikely to conflict with other skills. The domain is well-defined and distinct. | 3 / 3 |
Total | 12 / 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-structured instructional skill that provides a comprehensive framework for technical SEO auditing. Its main strengths are the clear 6-layer mental model, the prioritization guidance, and the failure patterns section. Its main weaknesses are the lack of concrete executable examples (no curl commands, no code snippets for validation, no specific tool configurations) and missing validation checkpoints in the workflow, particularly for high-risk migration scenarios.
Suggestions
Add concrete executable examples: curl commands for checking robots.txt/sitemaps, example validation scripts, or specific tool commands (e.g., Screaming Frog CLI, Lighthouse CLI) to make the workflow actionable rather than directional.
Add explicit validation gates in the workflow, especially for migrations: e.g., 'Verify redirect map covers 100% of indexed URLs before proceeding' and 'Post-migration: re-crawl within 24h and compare indexed URL counts.'
Provide the referenced bundle files (audit-template.md and migration-checklist.md) so the progressive disclosure actually works, or inline a minimal version of the audit template.
In the 6-layer framework, add specific check commands or methods for each item (e.g., 'curl -I https://example.com/robots.txt' to verify status, 'grep noindex' on rendered HTML) to move from checklist to executable guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is mostly efficient and well-organized, but includes some sections that could be tightened. The 'When NOT to use' section and 'Required inputs' section add useful context but the 6-layer framework descriptions contain some explanatory text that Claude would already know (e.g., 'Canonicals are hints, not directives'). Overall reasonably lean for the breadth of the topic. | 2 / 3 |
Actionability | The skill provides a clear checklist-style framework and workflow steps, but lacks concrete executable commands, code snippets, or tool-specific instructions. Guidance like 'Use a crawler to enumerate URLs' and 'test with the URL Inspection tool' is directional rather than executable. No specific curl commands, script examples, or tool configurations are provided. | 2 / 3 |
Workflow Clarity | The 7-step workflow is clearly sequenced and logically ordered, but lacks explicit validation checkpoints and feedback loops. For an audit involving potentially destructive actions (migrations, redirect maps), there's no 'validate then proceed' pattern. The cross-reference step (step 5) is a partial validation but isn't framed as a gate. Missing verification steps for migration scenarios cap this at 2. | 2 / 3 |
Progressive Disclosure | The skill references two external files (audit-template.md and migration-checklist.md) which is good progressive disclosure design, and the 'When NOT to use' section cross-references other skills. However, no bundle files were provided, so the referenced files don't actually exist. The 6-layer framework is detailed inline which is appropriate for the overview, but the failure patterns and output format sections could potentially be split out. | 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 | |
8e70d03
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.