seo

Optimize for search engine visibility and ranking. Use when asked to "improve SEO", "optimize for search", "fix meta tags", "add structured data", "sitemap optimization", or "search engine optimization".

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Quality

Content

81%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 comprehensive, highly actionable SEO skill with excellent code examples, a validated audit workflow, and a clearly signaled reference split for structured data. Its main weakness is conciseness: extensive guideline bullets restate well-known SEO basics and much detailed content remains inline rather than progressively disclosed.

Suggestions

Trim or collapse the per-section "guidelines" bullet lists that restate basics Claude already knows (e.g., "Use hyphens, not underscores", "Lowercase only", "Fix broken links promptly"), keeping only the non-obvious calibration notes.

Move the Mobile SEO and International SEO reference blocks into separate files under references/ and link to them from SKILL.md, mirroring the existing STRUCTURED-DATA.md split, to reduce inline bulk.

Consider consolidating the near-identical title/meta-description "linting proxy" caveats into one statement rather than repeating the framing in each section.

Dimension	Reasoning	Score
Conciseness	Mostly efficient with high-value calibrated nuance (title-link rewriting, llms.txt cautions), but the repeated guidelines bullet lists restate SEO basics Claude already knows ("Use hyphens, not underscores", "Lowercase only", "Fix broken links promptly") and the body is long enough to tighten.	3 / 5
Actionability	Copious copy-paste-ready examples (robots.txt, meta robots, canonical, sitemap XML, title/meta/heading/image/link markup, hreflang, viewport, CSS) plus concrete tool invocations (Chrome DevTools MCP `lighthouse_audit`, Lighthouse CLI) cover the common SEO cases fully.	5 / 5
Workflow Clarity	The "Evidence-led audit workflow" is a clearly sequenced four-step process with explicit validation ("Fix the source and re-run the same checks") and a feedback loop, and the SEO audit checklist reinforces the sequence with prioritized checkpoints.	5 / 5
Progressive Disclosure	Structure is good and the one bundle file is well-signaled ("Read [the structured data reference](references/STRUCTURED-DATA.md) when...") at one level deep, but a large amount of technical/on-page/mobile/international detail is inlined in SKILL.md rather than split into further reference files.	4 / 5
	Total	17 / 20 Passed

Description

91%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, well-constructed description that clearly states the skill's purpose and gives concrete, natural-language triggers covering both the acronym and full phrasing of SEO. The only weakness is minor overlap with adjacent web-quality skills and a slightly high-level headline capability.

Dimension	Reasoning	Score
Specificity	Names the SEO domain and lists several specific actions ("optimize for search", "fix meta tags", "add structured data", "sitemap optimization"), though the headline capability ("optimize for search engine visibility and ranking") stays somewhat high-level rather than enumerating every sub-action.	4 / 5
Completeness	Explicitly answers both what ("Optimize for search engine visibility and ranking") and when ("Use when asked to..." with concrete trigger phrases), matching the anchor example for a complete description.	5 / 5
Trigger Term Quality	Comprehensive natural trigger coverage including the acronym ("improve SEO"), full phrase ("search engine optimization"), and specific task asks ("fix meta tags", "add structured data", "sitemap optimization") that users would naturally say.	5 / 5
Distinctiveness Conflict Risk	SEO is a clear niche with distinct triggers, but "add structured data" and meta-tag work overlap slightly with referenced sibling skills (web-quality-audit, core-web-vitals), giving minor conflict risk rather than none.	4 / 5
	Total	18 / 20 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
relative_links	Relative link issues: 2 suspicious	Warning

	Total	15 / 16 Passed

Repository: addyosmani/web-quality-skills
Path: skills/seo/SKILL.md
Commit: afa8da9

Reviewed: 5 days ago

Table of Contents

Discovery Implementation Validation

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.