CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

seo-audit

Run a full-site SEO audit and return a scored, prioritized report. Use only for site-wide checks; use seo-page for one URL or seo-technical for a technical-only review.

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

77%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An unusually actionable orchestrator skill: exact commands, precise crawl configuration, conditional subagent routing, and excellent error-recovery guidance. Its weaknesses are redundancy (integration sections duplicating step 4, a repeated report command) and a monolithic 200-line body with no reference files for report templates and the data envelope.

Suggestions

Consolidate the DataForSEO/Google/Matomo integration sections: keep step 4 as the single source of spawn conditions and retain only the unique details (field-data benefits, Matomo/GA4 segmentation caveat) to remove the duplication.

Move the report-structure template and the audit-data.json envelope schema into reference files (e.g., references/report-structure.md and references/audit-data-schema.json), leaving SKILL.md as a lean overview with well-signaled one-level-deep references.

State the google_report.py command once (in Output Files) and reference it from the envelope section instead of repeating the full flag list verbatim.

DimensionReasoningScore

Conciseness

The body is mostly efficient and decision-dense (commands, weights, thresholds), but the DataForSEO/Google/Matomo integration sections restate spawn conditions already given in step 4, and the full google_report.py command appears verbatim in both Output Files and the envelope section. This is more than the 4 anchor's 'minor instances of over-explanation', fitting the 3 anchor's 'could be tightened'.

3 / 5

Actionability

Guidance is fully executable: copy-paste-ready commands with flags ("run render_page.py <url> --mode auto --json", "run seo_updates.py --since <yyyy-mm> --limit 0 --json"), exact crawl limits (500 pages, 30s timeout, 5 concurrent), concrete output paths, and a complete audit-data.json envelope shape. This matches the 5 anchor.

5 / 5

Workflow Clarity

A clear 7-step sequence with explicit conditional subagent spawn rules and a thorough error-handling table providing feedback loops for the batch crawl (429 backoff, timeout caps, robots.txt limits, partial-findings recovery after maxTurns). Explicit validation and recovery steps match the 5 anchor rather than 4.

5 / 5

Progressive Disclosure

The single ~200-line file has clear section headers but no reference files at all, and inline content that belongs in references (the full report-structure template and the audit-data.json envelope schema). Combined with duplicated integration content, this fits the 3 anchor ('content that should be separate is inline') better than the 4 anchor's 'minor organization gaps'.

3 / 5

Total

16

/

20

Passed

Description

82%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A crisp, well-routed description that clearly states what the skill does, when to use it, and when to use sibling skills instead. Its main weakness is that it names only two actions, underselling the audit's concrete capabilities (crawl depth, 0-100 scoring, prioritized action plan, PDF report).

Suggestions

Mention 1-2 signature deliverables to sharpen the 'what', e.g., "Run a full-site SEO audit (crawls up to 500 pages) and return a scored 0-100 SEO Health report with a prioritized action plan."

Add one or two natural phrasing variants users might say, such as "website SEO check" or "site-wide search audit", to broaden trigger coverage.

DimensionReasoningScore

Specificity

The description names the domain and two concrete actions ("Run a full-site SEO audit and return a scored, prioritized report") but omits the audit's broader capability set (crawling, subagent analysis, PDF reporting). It matches the 3 anchor (1-2 concrete actions, not comprehensive) rather than 4, which expects several listed actions.

3 / 5

Completeness

It explicitly answers both what ("Run a full-site SEO audit and return a scored, prioritized report") and when ("Use only for site-wide checks") with concrete trigger distinctions. The when-clause is explicit and specific with routing to alternatives, matching the 5 anchor rather than 4 where the when could be more explicit.

5 / 5

Trigger Term Quality

Natural user phrases like "SEO audit", "full-site", "site-wide checks", and "one URL" are present and would be said by users needing this skill. A few common variations (e.g., "website audit", "search ranking check") are missing, fitting the 4 anchor rather than the 5 anchor's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche and actively routes overlapping cases to sibling skills ("use seo-page for one URL or seo-technical for a technical-only review"), minimizing wrong-skill triggers. This matches the 5 anchor's clear niche with distinct triggers.

5 / 5

Total

17

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

AgriciDaniel/claude-seo

Path

skills/seo-audit/SKILL.md

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.