seo-hreflang

Validate hreflang language-region codes and generate standards-compliant tags for HTML, sitemaps, or headers.

1|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/Postalocity/template-microsite --skill seo-hreflang-postalocity
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: seo-hreflang
Source: https://github.com/Postalocity/template-microsite/tree/main/.opencode/integrations/claude-seo/seo-hreflang
Command: npx skills add https://github.com/Postalocity/template-microsite --skill seo-hreflang-postalocity

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Multilingual websites often suffer from misconfigured hreflang implementations, causing search engines to serve the wrong language version.

Core Features & Use Cases

  • Validate language codes against ISO 639-1
  • Validate region codes against ISO 3166-1 Alpha-2
  • Ensure self-referencing and bidirectional return tags
  • Generate correct hreflang tags for HTML, XML sitemaps, or HTTP headers
  • Align canonical URLs and support x-default fallbacks
  • Use case: Audit a site with en/fr/de for a multilingual product page and generate ready-to-deploy hreflang snippets

Quick Start

Audit a live site to produce hreflang snippets for all language variants.

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 multilingual site?

Generate hreflang tags for HTML pages, XML sitemaps, or HTTP headers to support consistent international targeting. The generated tags enforce x-default fallbacks and align canonical URLs, producing ready-to-deploy snippets for multilingual sites.

Why does hreflang validation require bidirectional return tags?

Hreflang validation requires bidirectional return tags because search engines need reciprocal references between language versions to confirm targeting. Without bidirectional mapping, incorrect hreflang deployments cause search engines to serve the wrong language version to users.

Can I use hreflang tags in HTTP headers and cross-domain sitemaps?

Yes, hreflang tags can be applied to HTTP header-based implementations and cross-domain sitemaps. The validation process enforces x-default references and canonical URL alignment across these formats to ensure consistent multilingual targeting.

What is the best way to fix incorrect hreflang deployments on live multilingual pages?

Fix incorrect hreflang deployments by auditing live pages to validate language-region codes and tag relationships. This generates standards-compliant hreflang tags, aligns canonical URLs, and supports x-default fallbacks for ready-to-deploy snippets across HTML and sitemaps.

Do I need to align canonical URLs when generating hreflang tags?

Yes, you must align canonical URLs when generating hreflang tags. Canonical URL alignment ensures search engines correctly understand the relationship between duplicate or alternate pages, preventing wrong language versions from being served in international search results.