seo-hreflang

Validate and generate hreflang tags for HTML, headers, or XML sitemaps.

38|2|Updated Mar 29, 2026
One-click install
npx skills add https://github.com/WebDevPeterGriffin/The-VibeCode-Bible --skill seo-hreflang-webdevpetergriffin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: seo-hreflang
Source: https://github.com/WebDevPeterGriffin/The-VibeCode-Bible/tree/main/.agent/skills/claude-seo/skills/seo-hreflang
Command: npx skills add https://github.com/WebDevPeterGriffin/The-VibeCode-Bible --skill seo-hreflang-webdevpetergriffin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents international SEO issues by validating and generating correct hreflang tags so search engines understand language and region targeting.

Core Features & Use Cases

  • Validation of hreflang correctness: Checks self-referencing requirements, bidirectional return tag relationships, and proper x-default usage.
  • Standards-based code generation: Ensures language codes use ISO 639-1 and region codes use ISO 3166-1 Alpha-2 formatting.
  • Implementation-method support: Generates and validates hreflang for HTML link tags, HTTP headers, and XML sitemaps for scalable setups.

Quick Start

Generate a hreflang validation report and corrected hreflang set for your site’s alternate URLs when you paste the canonical URL list and tell the AI which hreflang method you want (HTML, headers, or sitemap).

Frequently Asked Questions about seo-hreflang

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate hreflang tags for an international SEO multi-region site?

Generate hreflang tags by providing a canonical URL list and selecting an implementation method like HTML, HTTP headers, or XML sitemaps. The output ensures bidirectional linking, self-referencing alternates, and valid x-default mapping for correct multi-region targeting.

Why are my hreflang tags causing indexing failures in search engines?

Hreflang indexing failures often occur when tags lack bidirectional return links, miss x-default mappings, or use incorrect ISO 639-1 and ISO 3166-1 formatting. Validating your hreflang set ensures strict code formatting and canonical URL alignment to resolve these targeting errors.

What is the best way to validate x-default hreflang and bidirectional return tags?

The best way to validate x-default hreflang and bidirectional return tags is through an automated audit that checks self-referencing requirements, return tag relationships, and consistent protocol handling across the entire alternate URL set.

Can I implement hreflang for XML sitemaps instead of HTML link tags?

Yes, you can implement hreflang for XML sitemaps instead of HTML link tags. The generator supports scalable setups across HTML link tags, HTTP headers, and XML sitemaps, applying strict ISO code formatting and canonical URL alignment for each method.

Do I need ISO 639-1 language codes for correct hreflang tag generation?

Yes, you need ISO 639-1 language codes and ISO 3166-1 Alpha-2 region codes for correct hreflang tag generation. Standards-based code formatting ensures search engines properly understand your international language and region targeting.

How do I fix inconsistent protocol handling across my hreflang set?

Fix inconsistent protocol handling across an hreflang set by validating the entire alternate URL group for canonical alignment and matching protocols. This process corrects broken bidirectional links and standardizes the implementation across HTML or XML sitemaps.