seo-hreflang

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

8|5|Updated Feb 18, 2026
One-click install
npx skills add https://github.com/shenxingy/Clade --skill seo-hreflang-shenxingy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: seo-hreflang
Source: https://github.com/shenxingy/Clade/tree/main/configs/skills/seo-hreflang
Command: npx skills add https://github.com/shenxingy/Clade --skill seo-hreflang-shenxingy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It prevents international SEO failures caused by incorrect or inconsistent hreflang implementations, including wrong language/region codes, missing self-references, and broken x-default setups.

Core Features & Use Cases

  • Hreflang audit & validation: Detects common hreflang mistakes such as missing self-referencing tags, missing bidirectional return tags, and x-default issues.
  • Code correctness checks: Validates language (ISO 639-1) and region (ISO 3166-1 Alpha-2) formats and catches common invalid values.
  • Implementation generation: Produces correct hreflang outputs for HTML link tags, HTTP header formats, and XML sitemap hreflang structures.
  • Related SEO analysis support: Recommends cultural adaptation and content parity checks for multi-language sites.

Quick Start

Ask the AI to audit and generate hreflang tags for your site URL: Provide the target URL when you request hreflang validation and implementation.

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

Hreflang validation detects missing self-referencing tags, missing bidirectional return tags, and invalid language or region codes to prevent international SEO indexing failures. It also checks x-default issues and canonical alignment across HTML, HTTP header, and XML sitemap outputs.

How do I generate hreflang tags for an XML sitemap?

You generate hreflang tags for an XML sitemap by creating specific hreflang structures that enforce canonical alignment and consistent URL formatting. This process also outputs correct HTML link tags and HTTP header formats for multi-language and multi-region websites.

What is the correct hreflang x-default setup for multi-language websites?

The correct hreflang x-default setup prevents international SEO failures by specifying a default page for unmatched language or region users. It requires enforcing canonical alignment and ensuring no missing bidirectional return tags exist across your site outputs.

Why is my hreflang implementation not working with canonical tags?

Hreflang implementation fails when there is incorrect canonical alignment or inconsistent URL formatting across HTML, HTTP header, and XML sitemap outputs. You must enforce canonical alignment and validate that all bidirectional return tags are correctly configured.

Does hreflang validation check for missing bidirectional return tags?

Yes, hreflang validation explicitly detects missing bidirectional return tags alongside missing self-referencing tags and invalid language codes. This ensures your multi-language website maintains proper canonical alignment and avoids international SEO indexing failures.