CtrlK
BlogDocsLog inGet started
Tessl Logo

seo-audit

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.

70

Quality

62%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/seo-audit/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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 skill description with excellent trigger term coverage and completeness. The explicit cross-references to related skills (programmatic-seo, schema-markup, ai-seo) are a standout feature that reduces conflict risk. The main weakness is that the 'what it does' portion could be more specific about the concrete actions the skill performs beyond 'audit, review, or diagnose.'

Suggestions

Add more specific concrete actions to the 'what' portion, e.g., 'Checks meta tags, analyzes page speed, identifies crawl errors, reviews heading hierarchy, evaluates internal linking, and assesses mobile-friendliness.'

DimensionReasoningScore

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 such as '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. The 'Use when' guidance is thorough, including edge cases like vague user requests. It also helpfully distinguishes from related skills (programmatic-seo, schema-markup, ai-seo).

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms users would actually say, including both technical terms ('core web vitals,' 'crawl errors,' 'indexing issues,' 'meta tags review') and casual/natural language ('my SEO is bad,' 'why am I not ranking,' 'my traffic dropped,' 'not showing up in Google'). This is comprehensive and well-thought-out.

3 / 3

Distinctiveness Conflict Risk

The description explicitly differentiates itself from related skills (programmatic-seo, schema-markup, ai-seo) with clear boundary guidance. 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 like a comprehensive SEO audit textbook rather than a concise instruction set for Claude. Its main strength is thoroughness — it covers all major SEO audit areas with specific metrics and a clear output format. However, it significantly over-explains concepts Claude already knows (basic SEO best practices, what meta descriptions are, E-E-A-T definitions), lacks executable code/commands, and would benefit greatly from splitting detailed checklists into separate reference files while keeping the main skill lean.

Suggestions

Drastically reduce inline content by moving detailed checklists (Technical SEO, On-Page SEO, Content Quality, Common Issues by Site Type) into separate reference files and keeping only the audit framework, workflow, and output format in SKILL.md.

Remove explanations of concepts Claude already knows — e.g., what title tags are, what E-E-A-T stands for, basic URL structure advice. Focus only on project-specific conventions and non-obvious guidance.

Add executable examples: concrete curl commands for checking robots.txt/sitemaps, specific web_fetch usage patterns, or shell commands for common audit checks rather than just listing what to check.

Add explicit validation checkpoints to the workflow — e.g., 'Before moving to on-page audit, confirm crawlability issues are documented' — to create a proper sequenced process with feedback loops.

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~350+ lines, with extensive lists of checklist items that Claude already knows (what title tags should look like, what meta descriptions are, what E-E-A-T stands for, basic URL structure advice). Much of this is standard SEO knowledge that doesn't need to be spelled out — Claude knows what 'descriptive file names' and 'alt text on all images' mean without being told.

1 / 3

Actionability

The skill provides structured checklists and specific thresholds (e.g., LCP < 2.5s, title tags 50-60 chars) which are useful, and the schema markup detection limitation section is genuinely actionable. However, there are no executable code snippets, no concrete curl/fetch commands, and most guidance is checklist-style rather than copy-paste ready instructions.

2 / 3

Workflow Clarity

There is a clear priority order (Crawlability → Technical → On-Page → Content → Authority) and the output format section provides good structure for deliverables. However, there are no validation checkpoints or feedback loops — no 'verify this before proceeding' steps, no error recovery guidance, and the audit process reads more like a reference document than a sequenced workflow.

2 / 3

Progressive Disclosure

The skill has a References section and Related Skills section pointing to other files, which is good. However, the massive amount of inline content (common issues by site type, full E-E-A-T breakdown, complete on-page audit checklists) should be split into separate reference files rather than included in the main SKILL.md. The content that is inline far exceeds what should be in an overview document.

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
coreyhaines31/marketingskills
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.