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".
The seo-hreflang skill is designed to assist webmasters, SEO specialists, and digital marketers in managing international SEO through proper hreflang implementation. Hreflang tags are essential for multi-language and multi-region websites to indicate to search engines the linguistic and regional targeting of each page. Misconfigured hreflang tags can lead to indexing issues, duplicate content problems, and lost traffic due to search engines not correctly serving the intended language version to users. This skill automates the auditing, validation, and generation of hreflang tags to ensure compliance with standards and best practices.
Key features of seo-hreflang include comprehensive validation checks such as verifying self-referencing tags, bidirectional return tags between pages, x-default fallback tags, language and region code correctness, canonical URL alignment, protocol consistency, and cross-domain support. It also identifies common mistakes, ranks them by severity, and provides guidance for fixing them. The skill supports multiple implementation methods including HTML link tags, HTTP headers, and XML sitemaps, making it flexible for different website architectures. Users can detect errors like missing self-references, invalid ISO language codes, incorrect region codes, or HTTPS/HTTP mismatches, ensuring that all language versions are properly interconnected and recognized by search engines.
This skill is particularly useful for global websites managing content in multiple languages or targeting multiple regions, as well as agencies performing international SEO audits. It helps teams maintain correct hreflang implementation during website launches, migrations, or expansions into new markets. By using seo-hreflang, users can enhance search engine visibility for localized content, reduce indexing issues, and improve user experience for international audiences.
You can invoke the skill with a URL to audit existing hreflang implementations. It checks for self-referencing tags, return tags, x-default, language and region code validity, canonical alignment, protocol consistency, and cross-domain support.
Yes, the skill supports validation and generation of hreflang tags in HTML link tags, HTTP headers, and XML sitemaps, allowing flexibility depending on your site setup.
It can detect missing self-references, missing return tags, missing x-default, invalid ISO language codes, incorrect region codes, hreflang on non-canonical URLs, HTTP/HTTPS mismatches, and trailing slash inconsistencies.
Yes, the skill supports cross-domain hreflang validation, ensuring return tags exist on both domains and recommending sitemap-based implementations for complex setups.
The skill is released under the MIT license, which allows free use, modification, and distribution with minimal restrictions.
Quick Setup:
.claude/skills/Repository
agricidaniel/claude-seo