seo-hreflang

SkillAI & models

Use when auditing or generating hreflang tags for i18n/multilingual SEO.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the seo-hreflang skill

What this skill tells your AI

The instructions your AI receives, as published by fusengine/agents in plugins/seo/skills/seo-hreflang/SKILL.md and read by ahel’s review.

Hreflang / i18n SEO

Workflow

  1. Detect hreflang tags (HTML <link>, HTTP header, or XML sitemap)
  2. Run scripts/parse-hreflang.ts → validate
  3. Check self-referencing, return tags, x-default
  4. Verify language/region codes (ISO 639-1 + ISO 3166-1)

Common Mistakes

  • ❌ Missing self-reference (<link rel="alternate" hreflang="fr" href="/fr/"> from /fr/)
  • ❌ Missing return tags (A → B but not B → A)
  • ❌ Invalid codes (en-UK instead of en-GB)
  • ❌ HTTP/HTTPS mismatch between alternates
  • ❌ Mixing trailing slashes

Implementation Options

  1. HTML head: <link rel="alternate" hreflang="fr-FR" href="https://example.com/fr/">
  2. HTTP Header: Link: <https://example.com/fr/>; rel="alternate"; hreflang="fr-FR"
  3. XML Sitemap: <xhtml:link rel="alternate" hreflang="fr-FR" href="https://example.com/fr/"/>

x-default

Required for international landing/locale selector pages:

<link rel="alternate" hreflang="x-default" href="https://example.com/">

Signals

GitHub stars
25
Forks
4
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
seo-hreflang-fusengine
Source
github.com/fusengine/agents