When the user wants to audit, review, or diagnose SEO issues on their site. Also use when the user mentions "SEO audit," "technical SEO," "why am I not ranking," "SEO issues," "on-page SEO," "meta tags review," "SEO health check," "my traffic dropped," "lost rankings," "not showing up in Google," "site isn't ranking," "Google update hit me," "page speed," "core web vitals," "crawl errors," or "indexing issues." Use this even if the user just says something vague like "my SEO is bad" or "help with SEO" — start with an audit. For building pages at scale to target keywords, see programmatic-seo. For adding structured data, see schema. For AI search optimization, see ai-seo.
56
62%
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-audit/SKILL.mdQuality
Discovery
89%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 a strong description with excellent trigger term coverage and completeness, including helpful cross-references to related skills that reduce conflict risk. Its main weakness is that the 'what it does' portion could be more specific about the concrete actions performed during an SEO audit (e.g., checking meta tags, analyzing page speed, reviewing crawl errors) rather than just saying 'audit, review, or diagnose.' The trigger terms are outstanding in covering both technical and conversational user language.
Suggestions
Add more specific concrete actions at the beginning, e.g., 'Audits websites for SEO issues including meta tag analysis, page speed evaluation, crawl error detection, internal linking review, and content optimization gaps.'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (SEO) and some actions like 'audit, review, or diagnose SEO issues,' but it doesn't list multiple specific concrete actions (e.g., check meta tags, analyze crawl errors, evaluate page speed scores, review internal linking). The actions remain somewhat high-level. | 2 / 3 |
Completeness | Clearly answers both 'what' (audit, review, diagnose SEO issues) and 'when' with an extensive explicit trigger list. It also includes boundary guidance distinguishing this skill from related skills (programmatic-seo, schema, ai-seo), which strengthens the 'when' component. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms users would actually say, including conversational phrases like 'why am I not ranking,' 'my traffic dropped,' 'not showing up in Google,' 'my SEO is bad,' plus technical terms like 'core web vitals,' 'crawl errors,' and 'indexing issues.' | 3 / 3 |
Distinctiveness Conflict Risk | Explicitly differentiates itself from related skills (programmatic-seo, schema, ai-seo) with clear boundary guidance. The focus on auditing/diagnosing SEO issues creates a distinct niche, and the cross-references reduce conflict risk significantly. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
35%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a comprehensive SEO audit guide that suffers primarily from excessive verbosity — it reads more like an SEO textbook than a skill file for Claude. Much of the content (basic SEO concepts, standard checklists) is knowledge Claude already possesses, and the international SEO section alone could be its own reference file. The skill's strengths are its structured output format, clear priority ordering, and the practical schema detection limitation warning.
Suggestions
Reduce the skill to ~100-150 lines by removing basic SEO knowledge Claude already has (what title tags are, what HTTPS is, E-E-A-T definitions) and keeping only non-obvious guidance, specific thresholds, and tool-specific gotchas.
Move the detailed checklists (on-page SEO, content quality, common issues by site type) into separate reference files and link to them, keeping only the audit framework and priority order in the main skill.
Add executable examples: a concrete curl command to check robots.txt, a web_fetch example to audit a page's title/H1, or a script snippet to parse sitemap XML — showing Claude exactly how to perform audit steps with available tools.
Add explicit validation checkpoints in the workflow, e.g., 'Before moving to on-page audit, confirm crawlability issues are documented — on-page findings are meaningless if pages aren't indexed.'
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose at ~400+ lines, with extensive checklist-style content that Claude already knows (what title tags are, what meta descriptions are, what HTTPS is, basic SEO concepts). Sections like 'Security & HTTPS', 'URL Structure', 'Meta Descriptions', and 'E-E-A-T Signals' are largely restating common SEO knowledge that Claude possesses. The international SEO section alone is massive and could be entirely in a reference file. | 1 / 3 |
Actionability | The skill provides structured checklists and specific thresholds (e.g., LCP < 2.5s, CLS < 0.1) which are useful, and includes some concrete commands like the JS console query for schema detection. However, it lacks executable code examples, specific curl/fetch commands, or copy-paste-ready scripts for performing audit steps. Most guidance is descriptive ('check for X') rather than showing exactly how to check. | 2 / 3 |
Workflow Clarity | The audit framework establishes a clear priority order (Crawlability → Technical → On-Page → Content → Authority) and the output format section provides good structure. However, there are no explicit validation checkpoints or feedback loops within the audit process itself — no 'if you find X, then do Y before proceeding' patterns. The initial assessment questions are good but the transition from assessment to audit execution is implicit. | 2 / 3 |
Progressive Disclosure | The skill references external files (references/international-seo.md, references/ai-writing-detection.md) and related skills, which is good. However, the massive international SEO section is inlined when it should largely live in the referenced file. The on-page SEO, content quality, and common issues sections are all inlined despite being reference-level detail that could be split out. No bundle files were provided to verify references exist. | 2 / 3 |
Total | 7 / 12 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 — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
0f39e12
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.