seo-hreflang

Validates and generates hreflang implementations for HTML, HTTP headers, or XML sitemaps.

Updated Feb 2, 2026
One-click install
npx skills add https://github.com/nishchaydev/emitra --skill seo-hreflang-nishchaydev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: seo-hreflang
Source: https://github.com/nishchaydev/emitra/tree/main/.agent/SEO%20SKILL/claude-seo-main/skills/seo-hreflang
Command: npx skills add https://github.com/nishchaydev/emitra --skill seo-hreflang-nishchaydev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Fixes hreflang errors that can cause search engines to ignore your entire international language targeting, leading to lost visibility in global search.

Core Features & Use Cases

  • Hreflang validation: Checks self-referencing tags, bidirectional return relationships, and required x-default coverage.
  • ISO code correctness: Validates language (ISO 639-1) and optional region (ISO 3166-1 Alpha-2) formats to prevent invalid tag sets.
  • Canonical alignment: Ensures hreflang is only placed on canonical URLs and that URL matching (including protocol and trailing slashes) is consistent.
  • Implementation output: Generates ready-to-use hreflang structures for HTML link tags, HTTP Link headers, or XML sitemap hreflang.

Quick Start

Run the command /seo hreflang audit https://example.com to validate your site’s hreflang implementation and produce a prioritized findings report with corrected tag output.

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?

Validate hreflang by checking self-referencing alternates, bidirectional return relationships, and required x-default coverage. This hreflang validation ensures search engines properly recognize your international language targeting across multilingual sites.

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

Generate hreflang for XML sitemaps by applying correct ISO 639-1 language and ISO 3166-1 Alpha-2 region codes. This sitemap generation outputs ready-to-use hreflang structures ensuring exact URL matching including trailing slash and protocol alignment.

Why does my hreflang implementation fail canonical URL consistency checks?

Hreflang fails canonical alignment when placed on non-canonical URLs or when URL matching is inconsistent. Canonical alignment requires exact protocol and trailing slash consistency to prevent search engines from ignoring your international targeting.

Do I need an x-default hreflang tag for multi-regional sites?

Yes, an x-default hreflang tag is a required fallback for multi-regional sites. The x-default tag directs users without a specific language or region match to a default page, satisfying strict international SEO requirements.

Can I output hreflang annotations as HTTP Link headers instead of HTML tags?

Yes, you can output hreflang annotations as HTTP Link headers instead of HTML link tags. This implementation generates ready-to-use hreflang structures maintaining canonical alignment and bidirectional return tags for international SEO.

What are the limitations of using invalid ISO language codes in hreflang tags?

Invalid ISO language codes cause search engines to ignore your entire international targeting. ISO code correctness requires validating language (ISO 639-1) and optional region (ISO 3166-1 Alpha-2) formats to prevent invalid hreflang tag sets.