seo-hreflang

Validate and generate hreflang implementations for multilingual sites.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It eliminates hreflang and international SEO issues that prevent search engines from correctly understanding language and regional page targeting.

Core Features & Use Cases

  • Hreflang validation: Detect missing self-referencing tags, missing return tags (bidirectional relationships), and missing x-default.
  • Code correctness checks: Validate ISO 639-1 language codes and ISO 3166-1 Alpha-2 region codes, and flag common formatting errors.
  • Implementation support: Generate correct hreflang for HTML link tags, HTTP Link headers, and XML hreflang sitemap structures.
  • International SEO depth: Assess cultural adaptation and run content parity audits across language versions, including locale formatting checks.

Quick Start

Run /seo hreflang audit https://example.com to validate existing hreflang, generate corrected tags, and produce an issues-focused audit report.

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

Hreflang validation detects missing self-referencing tags, missing return tags for bidirectional relationships, and missing x-default annotations to ensure correct international SEO targeting across multilingual sites.

What is the best way to generate hreflang annotations for XML sitemaps and HTTP headers?

Generating hreflang annotations requires creating correct HTML link tags, HTTP Link headers, and XML hreflang sitemap structures while enforcing strict ISO 639-1 language and ISO 3166-1 Alpha-2 region code validation.

Why does my hreflang implementation fail due to language and region code formatting?

Hreflang implementation fails when language and region codes do not match strict ISO 639-1 and ISO 3166-1 Alpha-2 standards, or when protocol and trailing-slash consistency checks are not enforced across alternate URLs.

How do I audit content parity across different language versions of a website?

Auditing content parity across language versions involves running reference-driven scoring to assess cultural adaptation and locale formatting, ensuring aligned canonical URLs and equivalent content across multilingual pages.

Can I use x-default hreflang to specify a default page for unmatched regional languages?

Using x-default hreflang specifies a default page for unmatched regional languages, enforcing proper bidirectional return-tag relationships and aligning canonical URLs across HTML, HTTP headers, and XML sitemaps.

When do I need hreflang annotations for a multi-regional website?

Hreflang annotations are needed for multi-regional websites when you must direct search engines to correctly understand language and regional page targeting, requiring strict code validation and protocol consistency checks.