CtrlK
BlogDocsLog inGet started
Tessl Logo

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". Do NOT use for accessibility (use web-accessibility), performance (use core-web-vitals), or comprehensive site audits covering multiple areas (use web-quality-audit).

64

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./packages/skills-catalog/skills/(quality)/seo/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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, copy-paste-ready SEO reference with excellent code examples and a clear prioritized audit checklist. Its main gaps are conciseness/progressive-disclosure: substantial reference material is inlined into SKILL.md instead of being split into organized bundle files.

Suggestions

Move the full JSON-LD structured-data examples and/or the detailed audit checklist into separate reference files (e.g., references/structured-data.md, references/audit-checklist.md) and link to them from SKILL.md to improve progressive disclosure and reduce token load.

Add an explicit validate → fix → re-validate feedback loop for structured-data implementation to raise workflow clarity.

Trim redundant example variants where a single canonical example plus a guideline list would convey the same information.

DimensionReasoningScore

Conciseness

The body is mostly lean code-with-guidelines and avoids explaining concepts Claude already knows, but it inlines a large bulk reference (~520 lines of full JSON-LD, sitemap, and checklist examples) that could be tightened or split, placing it just above the midpoint rather than fully efficient.

3 / 5

Actionability

It provides extensive copy-paste-ready code (robots.txt, meta robots, canonical, sitemap XML, JSON-LD for Organization/Article/Product/FAQ/Breadcrumbs, CSS) with explicit ❌/✅ good-vs-bad pairs and concrete guideline lists covering common cases.

5 / 5

Workflow Clarity

The prioritized SEO audit checklist (Critical → High → Medium → Ongoing) gives a clear sequence, and structured-data validation is pointed to (Rich Results Test, Schema.org Validator), but there is no explicit error-recovery feedback loop, keeping it just below a 5.

4 / 5

Progressive Disclosure

Content is well-sectioned with headers and cross-skill references (Core Web Vitals, Web Quality Audit) are clearly signaled one level deep, but no bundle files exist and significant reference bulk (multiple full JSON-LD examples, the large audit checklist) is inlined in SKILL.md rather than split into separate files.

3 / 5

Total

15

/

20

Passed

Description

85%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 well-constructed description with excellent trigger phrases, explicit when-guidance, and strong boundary disambiguation. Its only weakness is that the "what" is a single abstract action rather than a list of concrete capabilities.

Suggestions

Enumerate 2-3 concrete actions in the "what" clause (e.g., "Audit on-page SEO, generate XML sitemaps and robots.txt, and add JSON-LD structured data") to raise specificity.

Keep the existing trigger phrases and negative boundary guidance, which are already strong.

DimensionReasoningScore

Specificity

The phrase "Optimize for search engine visibility and ranking" names the domain but offers only a single abstract action with no concrete capabilities enumerated (the quoted phrases are triggers, not actions), matching the anchor for minimal/generic actions.

2 / 5

Completeness

It explicitly states what ("Optimize for search engine visibility and ranking") and when (concrete "Use when asked to..." trigger phrases), plus negative boundary guidance, fully answering both questions.

5 / 5

Trigger Term Quality

The description lists natural phrases users actually say — "improve SEO", "optimize for search", "fix meta tags", "add structured data", "sitemap optimization", "search engine optimization" — giving comprehensive keyword coverage.

5 / 5

Distinctiveness Conflict Risk

A clear SEO niche with explicit "Do NOT use for..." disambiguation against sibling skills (web-accessibility, core-web-vitals, web-quality-audit) minimizes conflict risk.

5 / 5

Total

17

/

20

Passed

Validation

87%

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

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (533 lines); consider splitting into references/ and linking

Warning

relative_links

Relative link issues: 3 suspicious

Warning

Total

14

/

16

Passed

Repository
tech-leads-club/agent-skills
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.