seo-hreflang

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

Updated Dec 29, 2025
One-click install
npx skills add https://github.com/Flexksx/alemar-capoeira-chisinau --skill seo-hreflang-flexksx
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: seo-hreflang
Source: https://github.com/Flexksx/alemar-capoeira-chisinau/tree/main/.claude/skills/seo-hreflang
Command: npx skills add https://github.com/Flexksx/alemar-capoeira-chisinau --skill seo-hreflang-flexksx

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Hreflang and international SEO fixes missing or incorrect language-region targeting so search engines can correctly map each page to the right locale.

Core Features & Use Cases

  • Hreflang validation: Detects missing self-referencing tags, missing bidirectional return relationships, missing x-default, and canonical URL mismatches.
  • Code and URL correctness checks: Validates ISO language (ISO 639-1) and region (ISO 3166-1 Alpha-2) formats and enforces protocol and trailing-slash consistency.
  • Generation across implementations: Produces hreflang for HTML link tags, HTTP header format, or XML sitemap xhtml:link entries.
  • Optional SEO localization assessment: Supports cultural adaptation checks and content parity audits for multi-language sites using reference methodologies.

Quick Start

Use the seo-hreflang skill to audit your website at https://example.com for hreflang issues and generate corrected hreflang tags.

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?▼

Hreflang validation detects missing self-referencing tags, absent bidirectional return relationships, missing x-default attributes, and canonical URL mismatches to ensure correct multi-region targeting. It checks ISO 639-1 language codes and ISO 3166-1 Alpha-2 region codes for compliance.

What is the correct format for hreflang tags in an XML sitemap?▼

Hreflang tags in an XML sitemap use xhtml:link entries to specify alternate language and region URLs. This implementation format allows search engines to map multi-language pages correctly without inserting HTML link tags directly into page headers.

How do I generate hreflang annotations for HTTP headers?▼

Generating hreflang for HTTP headers involves formatting alternate language-region URL mappings into header responses. This approach suits non-HTML documents like PDFs, ensuring search engines receive proper international SEO targeting directives.

Does hreflang require x-default and canonical URL alignment?▼

Yes, hreflang implementations require x-default to specify a default language page and canonical URL alignment to prevent conflicts. Validating protocol consistency and trailing-slash uniformity ensures search engines correctly map each page to the right locale.

Why does my hreflang implementation fail due to language code errors?▼

Hreflang implementation fails when language and region codes violate ISO 639-1 and ISO 3166-1 Alpha-2 formatting rules. Code correctness checks validate these structures, enforcing protocol and trailing-slash consistency to resolve international SEO targeting errors.

Can I audit content parity and cultural adaptation for multi-language sites?▼

Yes, optional SEO localization assessment supports cultural adaptation checks and content parity audits for multi-language sites. This uses reference methodologies to verify that international pages match the structural intent of the primary locale.