This handles the tedious parts of international SEO: validating existing hreflang implementations and generating correct tags for multi-language sites. It catches the critical mistakes that kill hreflang (missing self-references, broken return tags, invalid language codes like "eng" instead of "en"), and supports all three implementation methods (HTML link tags, HTTP headers, XML sitemaps). You get validation reports that show exactly what's broken and why, plus it generates the actual code you need. Most useful when you're dealing with cross-domain sites or have more than a handful of language variants where manual tracking becomes error-prone. The validation checks are comprehensive enough to catch the subtle issues Google actually cares about.

skills.sh installs
7.4K
GitHub stars
27.8K
last updated
Aug 21, 2026

Install

$ npx -y skills add agricidaniel/claude-seo --skill seo-hreflang --agent claude-code

Installs into .claude/skills of the current project.

Files

Hreflang & International SEO

Validate existing hreflang implementations or generate correct hreflang tags for multi-language and multi-region sites. Supports HTML, HTTP header, and XML sitemap implementations.

Validation Checks

1. Self-Referencing Tags

  • Every page must include an hreflang tag pointing to itself
  • The self-referencing URL must exactly match the page's canonical URL
  • Missing self-referencing tags cause Google to ignore the entire hreflang set

2. Return Tags

  • If page A links to page B with hreflang, page B must link back to page A
  • Every hreflang relationship must be bidirectional (A→B and B→A)
  • Missing return tags invalidate the hreflang signal for both pages
  • Check all language versions reference each other (full mesh)

3. x-default Tag

  • Recommended when a selector/fallback URL exists: designates the fallback page for unmatched languages/regions
  • Typically points to the language selector page or English version
  • Only one x-default per set of alternates
  • Must also have return tags from all other language versions

Sponsors

Details

Repository
github.com/agricidaniel/claude-seo
Category
Marketing & SEO
First seen
Apr 16, 2026

More from agricidaniel/claude-seo

All 25
1inferen-sh avatarai-social-media-contentinferen-sh/skills7Kskills.sh installs
2inferen-sh avatarnewsletter-curationinferen-sh/skills6.5Kskills.sh installs
3aws avatarrouting-traffic-with-route53-and-cloudfrontaws/agent-toolkit-for-awsConfigures Amazon Route 53 to route traffic to a CloudFront distribution using a custom domain. Use when setting up DNS alias records, alternate domain names (C6.5Kskills.sh installs
4jackwener avataropencli-browser-sitemapjackwener/opencliUse when driving a website with opencli browser and sitemap context is available, requested, or needed to avoid blind navigation. Guides agents to consume site 6.4Kskills.sh installs
5agricidaniel avatarseo-flowagricidaniel/claude-seoFLOW framework integration: evidence-led SEO using the Find → Leverage → Optimize → Win loop. Surfaces stage-specific AI prompts from the FLOW knowledge base (46.1Kskills.sh installs
6affaan-m avatarbrand-voiceaffaan-m/eccBuild a source-derived writing style profile from real posts, essays, launch notes, docs, or site copy, then reuse that profile across content, outreach, and so6Kskills.sh installs