seo-hreflang

Validate and generate hreflang tags for multi-language and multi-region websites.

Updated Jun 9, 2026
One-click install
npx skills add https://github.com/timikalo7/Execute --skill seo-hreflang-timikalo7
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: seo-hreflang
Source: https://github.com/timikalo7/Execute/tree/main/.claude/skill-library/claude-seo/skills/seo-hreflang
Command: npx skills add https://github.com/timikalo7/Execute --skill seo-hreflang-timikalo7

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Incorrect hreflang implementations cause Google to ignore international targeting signals entirely, sending the wrong language version of your pages to users in different countries. This Skill audits existing hreflang setups for critical errors like missing return tags and invalid language codes, and generates correct implementations in HTML, HTTP header, or XML sitemap format. ## 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. - Hreflang Generation: Produces ready-to-implement HTML link tags, HTTP headers, or XML sitemaps with full alternate sets for each page. - Cultural Adaptation & Content Parity Audits: Assesses whether localized pages match cultural expectations (CTAs, trust signals, legal references) and verifies content parity across language versions using word-count ratios and freshness tracking. - Use Case: You run an e-commerce site in English, German, French, and Japanese. Run the audit to discover that your German pages use en-uk instead of en-GB, lack return tags from the French version, and display US date formats — then receive corrected hreflang tags and a prioritized fix list. ## Quick Start Ask the assistant to audit the hreflang implementation on your website 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 my website?

Provide your site URL and the audit checks self-referencing tags, bidirectional return tags, x-default fallbacks, and language/region code validity against ISO 639-1 and ISO 3166-1. You receive a validation report with severity ratings and corrected tags ready to implement.

What are the most common hreflang mistakes?

The most critical errors are missing self-referencing tags and missing return tags, which cause Google to ignore the entire hreflang set. Other frequent issues include invalid codes like `eng` or `en-uk`, hreflang on non-canonical URLs, and mixed HTTP/HTTPS protocols.

Should I use HTML tags, HTTP headers, or XML sitemaps for hreflang?

HTML link tags suit small sites with under 50 variants, HTTP headers work for non-HTML files like PDFs, and XML sitemaps are recommended for large sites or cross-domain setups. Sitemaps offer centralized management and scale best.

Does hreflang work across different domains?

Yes, hreflang supports cross-domain implementations such as example.com and example.de. Both domains must include return tags, and sitemap-based implementation is recommended for cross-domain setups.

Why is Google ignoring my hreflang tags?

Google ignores hreflang sets with missing return tags, missing self-references, or tags placed on non-canonical URLs. Hreflang is a hint, not a directive, so canonical alignment and full bidirectional linking are required for the signal to count.

Can hreflang specify a region without a language code?

No, a country code alone is invalid in hreflang. You must always pair a language code with an optional region qualifier, such as `en-GB` or `pt-BR`, using ISO 639-1 for language and ISO 3166-1 Alpha-2 for region.