CtrlK
BlogDocsLog inGet started
Tessl Logo

sitemap

Use when auditing metadata, crawlability, structured data, or indexability related to Create and submit an XML sitemap. Verify the rendered HTML and HTTP response rather than relying only on source files.

52

Quality

59%

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 ./skills/sitemap/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

61%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.

The body is a compact, well-sectioned overview that correctly delegates implementation detail to a real one-level reference file. Its main weaknesses are missing verification steps (no explicit way to confirm the sitemap is valid or that a fix worked) and moderately actionable instructions that lean on vague phrases like "properly formatted" instead of concrete checks or commands.

Suggestions

Add explicit validation checkpoints: e.g. "Fetch https://<site>/sitemap.xml and confirm a 200 response with `Content-Type: application/xml`", "Validate the XML against the sitemap 0.9 schema", and "Re-check after fixing to confirm the change".

Replace vague phrases like "properly formatted" with the specific requirements (one-level-deep link to references/rule.md for the format spec) or show the minimal <urlset> skeleton inline.

Trim the opening conceptual sentence about what sitemaps are for, and remove the duplicated trailing rule-page URL and stray '---' separator.

DimensionReasoningScore

Conciseness

The body is short and sectioned, with the Quick Reference bullets and Check/Fix/Explain/Code Review sections carrying real information. The one padded spot is the opening sentence "Search engines may not discover all your pages through links alone—a sitemap ensures every important page gets indexed", which explains a concept Claude already knows; trimming it would reach the lean anchor at 5.

4 / 5

Actionability

Some concrete guidance exists — "a valid XML sitemap accessible at /sitemap.xml" and "proper priority and changefreq values" give specific targets — but there are no executable commands or code in the body (e.g. how to fetch/validate the sitemap, curl the URL, check the XML against the sitemap schema), and "properly formatted" is undefined here. This matches the 'some concrete guidance but incomplete' anchor rather than the mostly-executable anchor at 4.

3 / 5

Workflow Clarity

The Check → Fix → Explain → Code Review sections form a recognizable sequence, but there are no validation checkpoints: nothing says how to confirm the sitemap is valid or how to verify the fix took effect (e.g. re-fetch /sitemap.xml, validate XML, check the HTTP response). The operations are not destructive/batch so the hard cap at 3 doesn't force this score, but the missing checkpoints place it at the 'steps listed but validation gaps' anchor rather than 4.

3 / 5

Progressive Disclosure

The body is a lean overview with clear sections and a well-signaled, one-level-deep pointer — "For full implementation details, code examples, and framework-specific guidance, see `references/rule.md`" — and the referenced file exists and contains the expected detail (code example, why-it-matters). Minor organization gaps keep it below 5: the pointer is plain text rather than a link, the rule-page URL is duplicated from the frontmatter as a trailing bare line, and the closing '---' separator serves no structural purpose.

4 / 5

Total

14

/

20

Passed

Description

57%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.

The description has an explicit and natural 'Use when...' trigger clause with relevant SEO keywords, but the capability statement ('what') is underdeveloped — it conveys only a single verification action plus a caveat about rendered output. Adding the concrete capabilities (generate/validate an XML sitemap, submit to search consoles) and a couple of user-facing synonyms would lift both specificity and completeness.

Suggestions

State the 'what' explicitly before the trigger clause, e.g. "Create, validate, and submit an XML sitemap; verify it is accessible and correctly formatted in the rendered output and HTTP response. Use when auditing...".

Add natural trigger synonyms users would say, such as "SEO", "search engines", or "sitemap.xml", to improve trigger-term coverage.

Narrow the trigger terms to sitemap-specific language (e.g. drop the generic "metadata" and "structured data") to reduce overlap with sibling SEO skills.

DimensionReasoningScore

Specificity

The description names the domain ("auditing metadata, crawlability, structured data, or indexability") and gives one concrete action ("Verify the rendered HTML and HTTP response rather than relying only on source files"), matching the 'names domain and 1-2 concrete actions' anchor. It does not list several specific actions (generate, validate, submit a sitemap), so it falls short of 4.

3 / 5

Completeness

The 'when' is explicit ("Use when auditing metadata, crawlability, structured data, or indexability"), but the 'what' is thin: the only capability stated is "Verify the rendered HTML and HTTP response rather than relying only on source files", which reads as a caveat rather than a clear statement of what the skill does (create, validate, and submit an XML sitemap). This sits between the vague-'what' anchors and the both-present anchor at 4.

3 / 5

Trigger Term Quality

Natural SEO keywords are present — "auditing", "metadata", "crawlability", "structured data", "indexability", "XML sitemap" — which users auditing a site would plausibly say. Common variations like "SEO", "search engines", "Google Search Console", or "sitemap.xml" are missing, so it does not reach comprehensive coverage at 5.

4 / 5

Distinctiveness Conflict Risk

The sitemap niche is somewhat distinct, but the trigger terms "auditing metadata", "structured data", and "indexability" are shared with sibling SEO skills (meta-tag rules, structured-data rules), creating real overlap risk with closely related skills in the same category. It is more targeted than a generic 'helps with documents', yet not the clear-niche, minimal-conflict case at 5.

3 / 5

Total

13

/

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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository
thedaviddias/Front-End-Checklist
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.