seo-hreflang

Validate and generate hreflang tags for multi-language and multi-region websites.

2|Updated Jun 19, 2025
One-click install
npx skills add https://github.com/Prat05devs/dapper-city-threads --skill seo-hreflang-prat05devs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: seo-hreflang
Source: https://github.com/Prat05devs/dapper-city-threads/tree/main/.agent/skills/seo/seo-hreflang
Command: npx skills add https://github.com/Prat05devs/dapper-city-threads --skill seo-hreflang-prat05devs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Incorrect hreflang implementations cause search engines to ignore international targeting signals, sending users to the wrong language version of a site. This Skill audits existing hreflang setups for common mistakes and generates correct implementations in HTML, HTTP header, or XML sitemap format. ## Core Features & Use Cases - Hreflang Validation: Checks self-referencing tags, bidirectional return tags, x-default fallbacks, ISO 639-1 language codes, ISO 3166-1 region codes, canonical alignment, and protocol consistency. - Tag Generation: Produces ready-to-implement hreflang code as HTML link tags, HTTP headers, or XML sitemaps for large and cross-domain sites. - Localization Quality Audits: Assesses cultural adaptation, content parity across language versions, locale format consistency (numbers, dates, currencies), and machine-translation quality signals. - Use Case: A site with English, German, and Japanese versions is losing international traffic. Run the audit to discover missing return tags and an invalid en-uk region code, then receive a corrected hreflang sitemap ready to deploy. ## Quick Start Audit the hreflang implementation on https://example.com and generate corrected tags for all language versions.

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 on a multi-language website?▼

Run the hreflang audit against a URL to check self-referencing tags, bidirectional return tags, x-default presence, and ISO code validity. The output is a validation report table showing per-language status with severity-ranked issues and fixes.

What are the most common hreflang mistakes?▼

The most common mistakes are missing self-referencing tags, missing return tags between language versions, invalid codes like `eng` or `en-uk`, and hreflang placed on non-canonical URLs. Missing self-references and return tags are critical because Google ignores the entire hreflang set.

Should I use HTML tags, HTTP headers, or an XML sitemap for hreflang?▼

HTML link tags suit small sites with under 50 variants, HTTP headers work for non-HTML files like PDFs, and XML sitemaps are recommended for large or cross-domain sites. Sitemaps centralize management and avoid bloating the page head.

Does hreflang work across different domains?▼

Yes, hreflang supports cross-domain setups such as example.com and example.de, but return tags must exist on both domains. Both domains should be verified in Google Search Console, and sitemap-based implementation is recommended.

Why is my hreflang implementation being ignored by Google?▼

Google ignores hreflang sets with missing self-referencing tags, broken bidirectional return tags, or tags placed on non-canonical URLs. Mixed HTTP/HTTPS URLs and trailing-slash mismatches with the canonical URL also cause failures.

Can machine-translated content hurt international SEO?▼

Unreviewed machine translation is treated as scaled content abuse under Google's January 2025 Quality Rater Guidelines. The audit flags signals like identical body content across hreflang alternates, mismatched html lang attributes, and missing schema inLanguage fields.