seo-hreflang

Validates and generates hreflang tags for multi-language and multi-region websites.

Updated Sep 17, 2026
One-click install
npx skills add https://github.com/coseto6125/claude-setup --skill seo-hreflang-coseto6125
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: seo-hreflang
Source: https://github.com/coseto6125/claude-setup/tree/main/skills/seo-hreflang
Command: npx skills add https://github.com/coseto6125/claude-setup --skill seo-hreflang-coseto6125

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Multi-language and multi-region sites frequently ship broken hreflang implementations—missing return tags, invalid ISO language or region codes, and hreflang on non-canonical URLs—that cause Google to ignore international targeting signals entirely. This Skill audits existing implementations, detects these mistakes, and generates correct hreflang tags. ## Core Features & Use Cases - Hreflang Validation: Checks self-referencing tags, bidirectional return tags, x-default fallbacks, ISO 639-1 language codes, ISO 3166-1 region codes, canonical URL alignment, and protocol consistency. - Tag Generation: Produces hreflang implementations as HTML link tags, HTTP headers, or XML sitemaps, with method recommendations based on site scale. - Localization Audits: Assesses cultural adaptation, content parity across language versions, and locale format consistency (numbers, dates, currencies) using bundled reference profiles. - Use Case: A site with English, German, and Japanese versions is losing international traffic. Run the audit to find that the German pages lack return tags and use en-uk instead of en-GB, then generate a corrected hreflang sitemap ready to deploy. ## Quick Start Ask the assistant to audit the hreflang implementation for your site URL and generate corrected tags for all language versions.

Frequently Asked Questions about seo-hreflang

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate hreflang tags on a multi-language website?▼

Run the audit against your site URL to check self-referencing tags, bidirectional return tags, x-default fallbacks, and language or region code validity. The output is a validation report listing issues by severity with corrected tags ready to implement.

What are the most common hreflang mistakes?▼

The most common mistakes are missing self-referencing tags, missing return tags between language versions, invalid codes like `eng` or `en-uk`, and hreflang placed on non-canonical URLs. Missing return tags and self-references are critical because Google ignores the entire hreflang set.

Should I use HTML tags, HTTP headers, or an XML sitemap for hreflang?▼

Use HTML link tags for sites with fewer than 50 language variants, HTTP headers for non-HTML files like PDFs, and an XML sitemap for large sites or cross-domain setups. The sitemap method is recommended at scale because it centralizes management.

Does hreflang work across different domains?▼

Yes, hreflang works across domains such as example.com and example.de, but each domain must include return tags pointing to the other. The sitemap-based implementation is recommended for cross-domain setups, with Search Console verification for monitoring.

Why is Google ignoring my hreflang tags?▼

Google ignores hreflang sets with missing self-referencing tags, broken bidirectional return tags, or tags placed on non-canonical URLs. Mixed HTTP/HTTPS URLs and trailing-slash mismatches between canonical and hreflang URLs also cause validation failures.

Can I use a region code without a language code in hreflang?▼

No, a country code alone is invalid; you cannot specify a region without a language. Use the format language-REGION, such as `en-US` or `pt-BR`, with an ISO 639-1 language code and an ISO 3166-1 Alpha-2 region code.