seo-hreflang

Validate hreflang configurations across HTML, HTTP headers, and sitemaps.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Hreflang and international SEO audit, validation, and generation. Detects common mistakes, validates language/region codes, and generates correct hreflang implementations. Use when user says "hreflang", "i18n SEO", "international SEO", "multi-language", "multi-region", or "language tags".

Core Features & Use Cases

  • Validation checks for self-referencing tags, return tags, x-default, and language/region code compliance
  • ISO language code validation (ISO 639-1) and ISO region code validation (ISO 3166-1)
  • Canonical URL alignment and protocol consistency verification
  • Hreflang generation for HTML link tags, HTTP headers, and XML sitemaps
  • Use Case: Audit a multinational site to ensure all language variants properly interlink and fallbacks are correctly configured

Quick Start

Run /seo hreflang audit on a site directory or URL to generate an initial hreflang validation 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 a multi-language site?

Validate hreflang tags by checking self-referencing tags, return tags, x-default fallbacks, and ISO language/region code compliance across HTML, HTTP headers, and XML sitemaps. This ensures all language variants properly interlink and fallbacks are correctly configured.

What is the best way to audit international SEO hreflang configurations?

The best way to audit international SEO hreflang configurations is to verify canonical URL alignment, protocol consistency, and bidirectional links across all language variants. This detects common mistakes and validates language and region codes.

Can I generate hreflang annotations for XML sitemaps and HTTP headers?

Yes, you can generate hreflang annotations for XML sitemaps and HTTP headers, as well as HTML link tags. This process enforces ISO language codes, region qualifiers, and x-default fallbacks for cross-domain support.

Why does my hreflang validation fail when checking bidirectional links?

Hreflang validation fails on bidirectional links when return tags are missing or mismatched, canonical URLs are misaligned, or protocol consistency is broken. Enforcing ISO 639-1 language codes and ISO 3166-1 region codes resolves these conflicts.

Do I need x-default fallbacks for multilingual SEO?

Yes, x-default fallbacks are needed for multilingual SEO to specify a default page for unmatched language or region users. Validation checks ensure these fallbacks are correctly configured alongside self-referencing tags and return links.

Does international SEO hreflang validation support cross-domain setups?

Yes, international SEO hreflang validation supports cross-domain setups. It checks bidirectional links, protocol consistency, and canonical URL alignment across different domains, ensuring language variants properly interlink regardless of domain boundaries.