seo-hreflang

Validate and generate hreflang tags for multilingual websites.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill identifies, validates, and repairs hreflang implementations to prevent search engines from ignoring multilingual and multi-regional page sets, ensuring correct language/region targeting and canonical alignment.

Core Features & Use Cases

  • Comprehensive Validation: Detects missing self-referencing tags, absent return tags, missing x-default, protocol mismatches, canonical misalignment, and invalid language or region codes.
  • Generation & Output: Produces HTML link tags, HTTP header alternatives, or XML sitemap entries for correct hreflang implementations and prepares a corrected hreflang-sitemap.xml when applicable.
  • Cross-Domain & Scale Support: Supports cross-domain hreflang checks, sitemap-based implementations for large sites, and verification steps for bidirectional relationships.
  • Use Case: Audit a multinational ecommerce site to find broken hreflang relationships, generate corrected tags, and produce a sitemap-ready hreflang export for deployment.

Quick Start

Run the seo-hreflang skill to audit https://example.com and generate corrected hreflang tags and a hreflang-ready sitemap export.

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 a multilingual website?

To validate hreflang tags, check for missing self-referencing tags, absent return tags, missing x-default, protocol mismatches, and invalid ISO 639-1 or ISO 3166-1 codes. This ensures search engines correctly index multilingual and multi-regional page sets.

What is the best way to generate hreflang tags in an XML sitemap?

Generating hreflang tags in an XML sitemap requires producing valid sitemap entries for language and region alternatives. The process outputs a corrected hreflang-sitemap.xml file, supporting large-scale sites and cross-domain implementations.

Why does Google ignore my hreflang tags on international pages?

Google ignores hreflang tags when implementations have missing self-referencing tags, absent return tags, canonical misalignment, or invalid language codes. Validating bidirectional relationships and protocol consistency prevents these international SEO issues.

Can I use hreflang tags for cross-domain sites and HTTP headers?

Hreflang tags support cross-domain sites and HTTP header implementations. Validation checks bidirectional relationships and canonical URL consistency across different domains to ensure proper multilingual targeting.

How do I fix missing x-default and return-tag hreflang errors?

Fixing missing x-default and return-tag hreflang errors requires auditing HTML link tags to detect absent bidirectional references. Corrected generation produces valid HTML links, HTTP header alternatives, or XML sitemap entries.

Does hreflang validation require HTTP(S) access to web pages?

Hreflang validation requires HTTP(S) access to pages to verify canonical URL consistency, protocol alignment, and bidirectional return tags. This access enables accurate auditing of live multilingual and multi-regional website configurations.