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-markup. 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 ./.agents/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. The cross-references to related skills are a notable strength that reduces conflict risk. The main weakness is that the 'what' portion could be more specific about the concrete actions the skill performs beyond the general 'audit, review, diagnose' framing.
Suggestions
Add more specific concrete actions to the 'what' portion, e.g., 'Analyzes meta tags, checks page speed, identifies crawl errors, reviews heading hierarchy, evaluates internal linking structure, and assesses mobile-friendliness.'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (SEO auditing) and some actions like 'audit, review, or diagnose SEO issues,' but doesn't list specific concrete actions like 'check meta tags, analyze page speed scores, identify crawl errors, review heading structure.' 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 helpfully distinguishes itself from related skills (programmatic-seo, schema-markup, ai-seo) with cross-references. | 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,' alongside 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-markup, ai-seo) with clear boundary statements. The focus on auditing/diagnosing 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 skill reads more like a comprehensive SEO textbook than an efficient instruction set for Claude. Its main strength is thoroughness and the schema markup detection limitation callout, which adds genuinely novel operational knowledge. However, the vast majority of content restates SEO fundamentals that Claude already knows, making it highly token-inefficient, and it lacks executable code/commands that would make it truly actionable.
Suggestions
Cut 60-70% of the content by removing SEO fundamentals Claude already knows (E-E-A-T definitions, what meta descriptions are, basic HTTPS concepts) and focus only on operational instructions, tool-specific gotchas, and the specific output format expected.
Add executable code snippets — e.g., curl commands to check robots.txt, Python scripts to parse XML sitemaps, specific web_fetch calls to check title tags and heading structure on a given URL.
Split detailed checklists (Technical SEO, On-Page, Content Quality, Site Type issues) into separate reference files and keep SKILL.md as a concise overview with the workflow and pointers to those files.
Add explicit validation checkpoints in the workflow — e.g., 'After crawlability check, confirm at least N pages are indexable before proceeding to on-page audit' — to create feedback loops for the audit process.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose at ~350+ lines, with extensive lists of things Claude already knows (what E-E-A-T stands for, what meta descriptions are, what HTTPS is, basic image optimization concepts). Most sections are checklists of well-known SEO concepts that don't add novel knowledge — Claude already understands these fundamentals. The 'Common Issues by Site Type' section alone is largely general knowledge. | 1 / 3 |
Actionability | The skill provides structured checklists and a clear output format, but lacks executable code or specific commands. Guidance is mostly descriptive ('Check for unintentional blocks', 'Verify important pages allowed') rather than providing concrete steps like specific curl commands, code snippets for parsing sitemaps, or exact Search Console API calls. The schema markup detection limitation section is one of the few genuinely actionable parts with a specific JS snippet. | 2 / 3 |
Workflow Clarity | There is a clear priority order (Crawlability → Technical → On-Page → Content → Authority) and a structured output format, but the audit process lacks explicit validation checkpoints or feedback loops. There's no 'if you find X, then do Y before proceeding' logic. The workflow is more of a checklist than a sequenced process with verification steps. | 2 / 3 |
Progressive Disclosure | The skill references two external files (references/ai-writing-detection.md and related skills), but the vast majority of content is inline in a monolithic document. The detailed checklists for each audit area (Technical SEO, On-Page, Content Quality, Common Issues by Site Type) could be split into separate reference files, with SKILL.md serving as a concise overview pointing to them. | 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.
1cfe305
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.