audit-hreflang

Analyze hreflang tags for syntax, self-reference, return tags, x-default, and canonical alignment.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/seohow/seo --skill audit-hreflang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: audit-hreflang
Source: https://github.com/seohow/seo/tree/main/skills/international/audit-hreflang
Command: npx skills add https://github.com/seohow/seo --skill audit-hreflang

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

It helps identify and fix hreflang implementation issues to ensure correct international targeting and reduce SEO mistakes.

Core Features & Use Cases

  • Error Detection: Checks hreflang syntax, self-references, return tags, x-default, and canonical alignment.
  • Audit Reports: Provides prioritized issues with severity, required fixes, and effort estimation for international SEO improvements.
  • Use Case: An SEO specialist audits a multilingual site’s hreflang tags to troubleshoot ranking issues in different markets and ensures adherence to best practices.

Quick Start

Run the audit on the website or sitemap by providing the URLs or deployment environment details to get a comprehensive hreflang health report.

Frequently Asked Questions about audit-hreflang

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

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

Hreflang return tags are bidirectional links between alternate language pages. You validate return tags by verifying that each referenced URL points back to the original page, ensuring consistent international targeting.

Why does my hreflang setup cause ranking issues in local markets?

Hreflang setup causes ranking issues in local markets when syntax is invalid, self-references are missing, or canonical alignment is broken. Auditing these technical errors identifies the root cause of multilingual SEO targeting failures.

What is the best way to audit hreflang implementation on a multilingual website?

The best way to audit hreflang implementation on a multilingual website is to run a comprehensive scan of your URLs or sitemap, validating hreflang syntax, return tags, and x-default configuration to produce a prioritized health report.

Can I audit hreflang tags directly from a sitemap for multilingual sites?

Yes, you can audit hreflang tags directly from a sitemap for multilingual sites. Provide the sitemap URLs or deployment environment details to scan and verify hreflang implementation without needing individual page access.

How do I fix missing x-default and canonical alignment in hreflang?

To fix missing x-default and canonical alignment in hreflang, audit your international pages to detect misconfigurations, then follow a prioritized remediation plan that estimates severity and effort for each required fix.