seo-hreflang

Validate and generate hreflang implementations for HTML, HTTP headers, and XML sitemaps.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill prevents international SEO failures by detecting incorrect hreflang implementations, including invalid language/region codes, broken bidirectional return relationships, missing x-default, and canonical/protocol mismatches that cause search engines to ignore hreflang sets.

Core Features & Use Cases

  • Hreflang validation: Checks self-referencing tags, bidirectional return tags (full mesh), x-default presence, and canonical URL alignment.
  • Code correctness: Validates language codes against ISO 639-1 and region qualifiers against ISO 3166-1 Alpha-2 formatting rules.
  • Implementation generation & parity support: Generates hreflang outputs for HTML link tags, HTTP header Link values, and XML sitemap xhtml:link structures, and supports multi-language content parity and cultural adaptation review.

Quick Start

Use the hreflang skill to audit a site’s international language versions at https://example.com and produce a corrected hreflang implementation plan.

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 for international SEO errors?

Hreflang code correctness requires validating language codes against ISO 639-1 and region qualifiers against ISO 3166-1 Alpha-2 formatting rules. This ensures search engines properly interpret multi-language and multi-region page targeting without ignoring your hreflang sets.

Does hreflang work with XML sitemap xhtml:link entries?

Hreflang implementation supports XML sitemap xhtml:link entries, HTML link tags, and HTTP header Link alternates. Generating implementation-ready output across these three formats ensures comprehensive international SEO coverage for multi-language websites.

Why does Google ignore my hreflang tags on multi-region websites?

Search engines ignore hreflang tags when implementations contain invalid language/region codes, broken bidirectional return relationships, missing x-default, or canonical/protocol mismatches. Auditing these specific errors ensures search engines properly process your multi-region hreflang sets.

What is the best way to generate hreflang annotations for multi-language sites?

Generating hreflang annotations requires producing implementation-ready output for HTML link tags, HTTP header Link values, and XML sitemap xhtml:link structures. This guarantees protocol consistency and ISO-compliant language/region codes across all page versions.

Do I need x-default hreflang and canonical alignment for international SEO?

X-default hreflang and canonical alignment are required to prevent international SEO failures. Scanning for x-default requirements and canonical URL alignment ensures search engines correctly route users to appropriate language and regional page versions.