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

79%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/seo-audit/SKILL.md
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.

A highly actionable orchestrator skill with an exemplary error-handling section and copy-ready commands, envelope schema, and conditional subagent logic. Its weaknesses are inlined reference-grade material (envelope spec, generic report checklists) that inflates token cost and belongs in separate bundle files.

Suggestions

Move the Structured Audit Data Envelope schema into a reference file (e.g. references/audit-envelope.md) and keep only the path and a one-line summary in SKILL.md, since the schema is only needed when writing audit-data.json in step 6.

Trim the Report Structure section to the section headings and severity model; the per-bullet checklists ('Title tag issues', 'Missing alt text', 'E-E-A-T assessment') restate what the named subagents (seo-content, seo-technical) already cover and what Claude knows about SEO reports.

Consolidate the DataForSEO, Google API, Matomo, and Google Update Correlation integration sections into a single 'Optional Integrations' reference file, keeping the spawn conditions inline where the subagent list already states them.

DimensionReasoningScore

Conciseness

The project-specific material (commands, envelope schema, scoring weights, error handling) is dense and earns its tokens, but the 'Report Structure' section lists generic SEO checklists Claude already knows ('Title tag issues', 'Missing alt text', 'E-E-A-T assessment') and the Crawl Configuration block duplicates limits already stated in step 3. Not a 4: these are several removable sections, not minor trimmings; not a 2: most of the body is non-obvious, project-specific guidance rather than padding.

3 / 5

Actionability

Fully executable guidance throughout: exact invocation commands ('"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run render_page.py <url> --mode auto --json'), concrete output paths ('{domain}-audit/FULL-AUDIT-REPORT.md'), a complete copy-ready JSON envelope schema, a scoring weights table, and explicit conditional spawn conditions with auth-check commands. Specific examples cover the common cases.

5 / 5

Workflow Clarity

A clear 7-step sequence with explicit error-recovery feedback loops: the Error Handling table prescribes actions for unreachable URLs, robots.txt blocks, rate limiting, timeouts, and partial subagent findings ('Read whatever findings file exists and merge it into the report'). Conditional spawn rules (spawn when Local Service detected, when credentials check passes) act as checkpoints. This matches the anchor-5 example's validate-and-recover pattern adapted to an audit context.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), so everything — the ~40-line JSON envelope schema, the Report Structure checklists, and four integration sections — is inlined in a single ~200-line SKILL.md. Section headers and a flat structure keep it navigable (not a 2), but content that clearly belongs in separate reference files (the envelope spec, per-integration details) is inline, matching the anchor-3 pattern of '200 lines that could be in a separate file'.

3 / 5

Total

16

/

20

Passed

Description

73%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 strong, third-person description that pairs a concrete capability statement with explicit scope boundaries and sibling-skill routing. Its main gaps are a thin action list and trigger terms limited to scope selection rather than the natural phrases a user would say when needing a site audit.

DimensionReasoningScore

Specificity

Names the domain ('full-site SEO audit') with two concrete actions ('run a full-site SEO audit', 'return a scored, prioritized report'), but coverage stops there — crawling, subagent delegation, and reporting detail are absent. Not a 4: fewer than 'several specific actions'; not a 2: the actions named are concrete, not generic.

3 / 5

Completeness

Has a clear 'what' ('Run a full-site SEO audit and return a scored, prioritized report') and an explicit 'when' clause ('Use only for site-wide checks') plus negative guidance routing to seo-page/seo-technical. Not a 5: the 'when' is a scoping constraint rather than concrete trigger phrases like 'when the user mentions X'; not a 3: an explicit 'Use only for...' clause is present, so the completeness cap of 3 does not apply.

4 / 5

Trigger Term Quality

Good natural keyword coverage — 'SEO audit', 'site-wide checks', 'one URL', 'technical-only review' are phrases users would plausibly say. Not a 5: misses common synonyms/extensions users might say ('website audit', 'SEO check', 'search ranking review'); not a 3: the present terms go beyond a single generic keyword with relevant variations for scope selection.

4 / 5

Distinctiveness Conflict Risk

The description actively disambiguates from sibling skills ('use seo-page for one URL or seo-technical for a technical-only review'), carving a clear niche with minimal conflict risk. The routing guidance is stronger than the anchor-4 'minor overlap risk' case.

5 / 5

Total

16

/

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.