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.