CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

seo-hreflang

Hreflang and international SEO audit, validation, and generation. Detects common mistakes, validates language/region codes, and generates correct hreflang implementations. Use when user says "hreflang", "i18n SEO", "international SEO", "multi-language", "multi-region", or "language tags".

Quality

86%

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

SKILL.md
Quality
Evals
Security

Quality

Content

78%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 well-structured, highly actionable skill body with excellent progressive disclosure and executable examples for every implementation method. The main weakness is token efficiency: the tangential, date-stamped geo-targeting and regional Search-units sections (5b/5c) pad the file and will age poorly.

Suggestions

Move the region-specific Search units detail (section 5c) into a reference file (or trim it to a one-line pointer to the Google documentation) and strip the inline effective dates; dated facts belong in a dedicated/deprecated section, not the core validation body.

Compress section 5b to its two actionable rules — hreflang is a hint not a directive, and GSC country targeting was removed so it should not be recommended — without the surrounding context sentences.

The word-count ratio specifics in the Content Parity Audit section (DE 25-35% longer, JA 10-25% shorter) duplicate content-parity.md; a pointer to the reference file would suffice.

DimensionReasoningScore

Conciseness

The bulk is efficient — tight validation checklists, severity tables, and copy-paste code with no beginner-level explanation — but sections 5b and 5c (~25 lines) drift into tangential geo-targeting and regional Search-units detail carrying time-sensitive dates (2026-09-08, 2026-09-18, 2026-11-09, "removed in 2022") that are not placed in a deprecated/old-patterns section. This is more than 'minor instances that could be trimmed', so it sits at 3 rather than 4, while the otherwise lean body keeps it above 2.

3 / 5

Actionability

Fully executable, copy-paste-ready examples for all three implementation methods (HTML link tags, HTTP Link headers, XML sitemap with the xhtml namespace), plus concrete code-validation rules (en-GB vs en-uk, ja vs jp), severity-ranked mistake tables, report templates, and an error-handling table with specific remediation actions. The common cases are covered end to end.

5 / 5

Workflow Clarity

The generation process is a numbered 7-step sequence with embedded validation checkpoints (step 3 validates codes, step 5 verifies bidirectional return tags), and the error-handling table gives recovery actions for failure modes. It falls short of 5 because there is no explicit fix-then-revalidate loop in the generation process and the audit side is a checklist rather than an ordered workflow with checkpoints.

4 / 5

Progressive Disclosure

The core validation/generation knowledge lives inline while four substantive, one-level-deep reference files (cultural-profiles.md, locale-formats.md, content-parity.md, machine-translation-qa.md — all verified to exist) are clearly signaled in context and consolidated in a Reference Files section with an explicit 'Load on-demand... do NOT load all at startup' instruction. Structure and navigation match the top anchor.

5 / 5

Total

17

/

20

Passed

Description

88%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 description that clearly states concrete capabilities in third person and pairs them with an explicit, trigger-phrase-rich 'Use when' clause. The only gaps are a few missing natural synonyms (e.g., localization) and slight breadth in the international-SEO trigger terms.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "audit, validation, and generation", "Detects common mistakes", "validates language/region codes", "generates correct hreflang implementations" — giving comprehensive coverage of the skill's capabilities. It exceeds the 'several specific actions with minor gaps' anchor because the actions span the full audit-to-generation scope.

5 / 5

Completeness

Both what ("Detects common mistakes, validates language/region codes, and generates correct hreflang implementations") and when ("Use when user says 'hreflang', 'i18n SEO'...") are explicitly and concretely answered with named trigger phrases, matching the top anchor exactly.

5 / 5

Trigger Term Quality

Trigger terms "hreflang", "i18n SEO", "international SEO", "multi-language", "multi-region", "language tags" give good natural-phrase coverage including synonyms. Not 5 because common variations like "localization", "l10n", or "language targeting" are absent; not 3 since coverage goes well beyond 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

The hreflang niche is clear with a highly distinct primary trigger ("hreflang"), but broader terms like "international SEO" and "multi-language" create minor overlap risk with general SEO skills. Mostly distinct rather than minimal-conflict, so it sits at 4 rather than 5.

4 / 5

Total

18

/

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