seo-hreflang

Audit and validate hreflang configurations across multi-language sites.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Hreflang and international SEO configurations are prone to errors that degrade cross-language visibility. This skill audits, validates, and generates correct hreflang implementations across HTML, HTTP headers, and sitemap-based setups.

Core Features & Use Cases

  • Self-referencing & return tag validation: ensures each language variant references itself and that all alternates link back in a bidirectional mesh.
  • Code correctness: validates ISO 639-1 language codes and ISO 3166-1 region codes for all variants.
  • X-default & canonical alignment: recommends and enforces a proper x-default page and ensures canonical URL alignment across variants.
  • Use Case: for a site with en-US, fr, de, and ja-JP variants, verify proper interlinking and generate compliant hreflang implementations for HTML, HTTP, or sitemap delivery.

Quick Start

Run a quick audit of your site’s multilingual pages and request corrected hreflang tags for HTML, HTTP, or sitemap delivery.

Frequently Asked Questions about seo-hreflang

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

FAQPage Schema
How do I audit hreflang tags for international SEO errors?

To audit hreflang tags, validate self-referencing tags, bidirectional return links, and x-default attributes to identify common international SEO mistakes. This ensures canonical alignment and protocol consistency across multi-language sites.

What is hreflang bidirectional return tag validation?

Hreflang bidirectional return tag validation ensures each language variant links back to its alternates in a mesh. If an en-US page points to fr, the fr page must point back to en-US, preventing broken cross-language signals.

How do I generate hreflang markup for HTML, HTTP headers, or sitemaps?

Generate hreflang markup by validating ISO 639-1 language and ISO 3166-1 region codes, then outputting compliant tags for HTML, HTTP headers, or XML sitemaps. This ensures correct delivery across different site architectures.

Why does my hreflang configuration need an x-default tag?

An x-default tag is needed to specify a default page for unmatched language or region visitors. Auditing verifies proper x-default implementation and ensures canonical URL alignment across all language variants.

Can I validate cross-domain hreflang configurations for multiple language variants?

Yes, cross-domain hreflang configurations can be validated for multiple language variants like en-US, fr, de, and ja-JP. The audit checks interlinking, canonical alignment, and protocol consistency across different domains.

What are common hreflang mistakes when setting up multilingual sites?

Common hreflang mistakes include missing self-referencing tags, broken bidirectional return links, incorrect ISO 639-1 language or ISO 3166-1 region codes, and canonical URL misalignment across language variants.