CtrlK
BlogDocsLog inGet started
Tessl Logo

hreflang

Use when auditing metadata, crawlability, structured data, or indexability related to Add hreflang tags for multilingual sites. Verify the rendered HTML and HTTP response rather than relying only on source files.

60

Quality

70%

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

Quality

Content

72%

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

A well-structured, token-efficient overview that correctly defers detail to a single one-level-deep reference, but the body's own Check/Fix guidance is abstract and lacks the verification checkpoints needed for full workflow clarity.

Suggestions

Add at least one concrete hreflang snippet or the exact verification step (e.g. check reciprocal links / x-default) directly in the body rather than deferring all code to the reference.

Surface a brief validation/verification checkpoint in the Check or Code Review section so the audit workflow has an explicit pass/fail signal in the body.

Replace the tautological 'Check if this multilingual website properly implements hreflang tags' with a specific, ordered audit procedure.

DimensionReasoningScore

Conciseness

The body is a lean ~40 lines with terse sections and a concise Quick Reference; every section earns its place and it does not pad with library or concept explanations, matching the lean-and-efficient anchor.

3 / 3

Actionability

The Quick Reference gives concrete facts (x-default, reciprocal links, ISO 639-1/3166-1 codes) but the Fix/Check sections are abstract ('Add appropriate hreflang tags') and all executable code is deferred to the reference, so guidance is incomplete in the body itself.

2 / 3

Workflow Clarity

Check/Fix/Explain/Code Review provide a loose sequence but there are no explicit validation or verification checkpoints in the body (those live only in the reference file), matching the steps-listed-but-checkpoints-missing anchor.

2 / 3

Progressive Disclosure

The body is a clear overview that points to a real, one-level-deep `references/rule.md` for full implementation details, code examples, and framework-specific guidance, with well-signaled navigation and appropriately split content.

3 / 3

Total

10

/

12

Passed

Description

67%

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 'Use when' trigger and names concrete verification actions, but it is weighed down by SEO jargon and a templating artifact ('related to Add hreflang tags') that blurs natural trigger terms and overlap risk.

Suggestions

Reword the templating artifact 'related to Add hreflang tags for multilingual sites' into a natural clause so the sentence reads cleanly.

Add more common natural trigger terms (e.g. 'multilingual SEO', 'language tags', 'international pages') alongside the technical jargon.

Tighten the broad 'auditing metadata, crawlability, structured data, or indexability' framing to hreflang-specific actions to reduce overlap with sibling SEO skills.

DimensionReasoningScore

Specificity

Names the domain and a couple of actions ('auditing metadata, crawlability, structured data, or indexability', 'Verify the rendered HTML and HTTP response') but 'auditing' is a broad category rather than a list of multiple concrete actions, so it stops short of the comprehensive score-3 anchor.

2 / 3

Completeness

Explicitly states the 'when' via the 'Use when...' clause and the 'what' via auditing/verifying actions, satisfying the both-what-and-when anchor with explicit triggers.

3 / 3

Trigger Term Quality

Includes relevant keywords ('hreflang', 'multilingual sites', 'rendered HTML', 'HTTP response') but is heavy on SEO jargon ('crawlability', 'indexability', 'structured data') and the phrase 'related to Add hreflang tags' is a templating artifact, missing cleaner natural variations.

2 / 3

Distinctiveness Conflict Risk

The hreflang/multilingual framing narrows it, but the 'auditing metadata, crawlability, structured data, or indexability' phrasing is shared by many SEO checklist rules and could overlap with sibling i18n/SEO skills.

2 / 3

Total

9

/

12

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.

Validation15 / 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.