seo-hreflang

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

5|1|Updated Jan 7, 2026

Search Tags:#localization #seo audit #hreflang #international seo #language tags #xml sitemap

Ready to run

npx skills add https://github.com/htafolla/StringRay --skill seo-hreflang

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: seo-hreflang
Source: https://github.com/htafolla/StringRay/tree/main/ci-test-env/.opencode/integrations/claude-seo/seo-hreflang
Command: npx skills add https://github.com/htafolla/StringRay --skill seo-hreflang

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill solves the complexity and potential errors in implementing hreflang tags, ensuring search engines correctly serve your content to the right language and region.

Core Features & Use Cases

Hreflang Validation: Detects common mistakes like missing self-referencing or return tags, invalid language/region codes, and canonical URL mismatches.
Hreflang Generation: Creates correct hreflang implementations for HTML, HTTP headers, or XML sitemaps.
Use Case: A global e-commerce site needs to ensure its product pages are correctly localized. This Skill can audit the existing hreflang setup or generate a new, compliant XML sitemap for all language versions.

Quick Start

Use the seo-hreflang skill to validate the hreflang tags on example.com.

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 generation creates correct implementations for international SEO across HTML link elements, HTTP headers, or XML sitemaps. It supports multi-language and multi-region website configurations to ensure search engines serve the right localized content.

How do I generate hreflang tags for an XML sitemap?▼

Why does my hreflang implementation fail canonical URL alignment checks?▼

Hreflang implementation fails canonical URL alignment checks when your alternate language tags point to URLs that do not match the canonical versions of your pages. The Skill validates this alignment to prevent search engines from ignoring your localization directives.

Do I need a self-referencing hreflang tag and x-default tag for multi-region sites?▼

Yes, you need a self-referencing hreflang tag and an x-default tag for multi-region sites. The Skill addresses issues with both tag types to ensure your multi-language and multi-region website configurations are correctly interpreted by search engines.

What is the best way to audit hreflang return tags across HTML and HTTP headers?▼

The best way to audit hreflang return tags is to validate implementations across HTML, HTTP headers, and XML sitemaps. The Skill specifically detects missing return tags to ensure bidirectional language confirmation for international SEO.