seo-hreflang

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

4|Updated Aug 22, 2025
One-click install
npx skills add https://github.com/justin06lee/justin06lee.dev --skill seo-hreflang-justin06lee
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: seo-hreflang
Source: https://github.com/justin06lee/justin06lee.dev/tree/main/.gemini/skills/valhalla/skills/seo-hreflang
Command: npx skills add https://github.com/justin06lee/justin06lee.dev --skill seo-hreflang-justin06lee

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 for HTML, HTTP headers, or XML sitemaps. ## 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 header values, or XML sitemap entries 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, and Japanese. Run the audit to discover your German pages lack return tags and use the invalid code en-uk, then generate a corrected hreflang sitemap ready to deploy. ## 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 the site URL and the audit checks self-referencing tags, bidirectional return tags, x-default fallbacks, language and region code validity, canonical alignment, and protocol consistency. Results are reported as a validation table with severity ratings per issue.

How to generate hreflang tags for a multi-language site?

The generation process detects language versions, maps equivalent pages, validates codes against ISO 639-1 and ISO 3166-1, then outputs HTML link tags, HTTP headers, or an XML sitemap. Every page receives a full alternate set including a self-reference and x-default.

Should I use HTML tags, HTTP headers, or an XML sitemap 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 centralize management but require ongoing maintenance.

Why is Google ignoring my hreflang tags?

Common causes include missing return tags between language versions, absent self-referencing tags, hreflang placed on non-canonical URLs, or invalid codes like en-uk instead of en-GB. Any of these critical errors causes Google to ignore the entire hreflang set.

Does hreflang work across different domains?

Yes, hreflang supports cross-domain setups such as example.com and example.de, but return tags must exist on both domains. Sitemap-based implementation is recommended for cross-domain configurations, with Search Console verification for monitoring.

What are valid language and region codes for hreflang?

Languages must use ISO 639-1 two-letter codes like en, fr, or ja, with optional ISO 15924 script subtags such as zh-Hans. Regions use ISO 3166-1 Alpha-2 codes like en-US or pt-BR, and a region cannot appear without a language prefix.