All skills
agricidaniel avatar

/seo-hreflang

@93b720e
by Agrici.Danielagricidaniel/claude-seo18k stars
2,665

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".

Use this Skill: https://skilld.dev/gh/agricidaniel/claude-seo/seo-hreflang

This session only. Nothing lands on disk.

referencesmachine-translation-qa.md

≈879 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Machine-translation QA flag (September 11, 2025 QRG)

Google's January 23, 2025 Quality Rater Guidelines update added explicit language about machine-translated content with no human review as a form of scaled content abuse (§4.6.5). This is also the enforceable webmaster-facing spam policy (updated 2026-05-15), which names "automated transformations like synonymizing, translating, or other obfuscation techniques" as scaled content abuse: https://developers.google.com/search/docs/essentials/spam-policies

"Using automated tools (generative AI or otherwise) as a low-effort way to produce many pages that add little-to-no value."

Machine-translated content is fine when reviewed by a human speaker and corrected. Untranslated MT (or "lightly post-edited" output that still contains hallucinated terms, wrong gender/number agreement, or untranslated proper nouns) is treated as scaled content abuse.

Signals the seo-hreflang audit should surface

Signal Severity Notes
Multiple hreflang alternates point to URLs whose content is identical except for header chrome Critical Indicates the body wasn't translated; just template wrapped.
lang="xx" attribute on <html> doesn't match the body language High Translation pipeline output without a final QA step.
Auto-translated <meta name="description"> longer than 160 chars (untrimmed) Medium The translator overran the snippet limit; no human reviewer caught it.
lang attribute is auto or missing entirely Medium Pages that don't declare their language confuse hreflang + AI crawlers.
Untranslated proper nouns or product names sprinkled in body Low (heuristic) Common MT failure mode; hard to detect automatically.
Schema.org inLanguage field absent or wrong Medium Multi-language audits should cross-check inLanguage vs. body.

What the audit should NOT flag

  • Sites that have a few MT pages clearly labelled as MT (a human-translation-fallback pattern). Google's QRG explicitly permits MT when honestly labelled and clearly scoped.
  • Machine-translated UI strings: those are i18n, not "content".
  • Content with lang="auto" if the audit can't fetch a fallback signal (be conservative; don't claim what we can't verify).

Cross-skill delegation

  • For per-page hreflang validation, stay inside seo-hreflang.
  • For broader scaled-content scoring (entropy of translated pages, AI-pattern detection in body), defer to seo-content via "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run content_quality.py.
  • For "is this translated by Google's own auto-translate widget" detection, look for the .goog-te-banner-frame iframe. There is no per-mechanism exemption: in June 2025 Google removed the robots.txt-blocking guidance for auto-translated pages, and auto/AI- translated content is now judged case-by-case on user value. Use page-level noindex for low-value translated pages, not sitewide blocks; the widget also produces poor passage-citability.

Primary sources

Last verified: 2026-07-09.

Source: SKILL.md on GitHub

1 warning1d5 checks · Risk SAFE
  • Gen Agent Trust Hub1d

    The skill is an SEO utility for internationalization (hreflang) audits. It is generally safe but possesses a surface for indirect prompt injection because it analyzes external websites and local directories. It also suggests the use of a vendor-provided script for content quality assessments.

  • Socket1d

    No alerts

  • Snyk1d

    Risk: MEDIUM · 1 issue

  • Runlayer7mo

    1 file scanned · No issues

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at 93b720e. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 days ago.

Activeupdated 3 days ago
user-invocable
true
argument-hint
[url]
metadata
{
  "author": "AgriciDaniel",
  "version": "2.4.1",
  "category": "seo"
}
  • SEO
  • hreflang
  • international-seo
  • i18n
  • multi-language
  • validation
  • xml-sitemap
  • language-codes

README badge

README badge for agricidaniel/claude-seo/seo-hreflang

Audits and generates correct hreflang implementations for multi-language and multi-region sites, validating language/region codes, self-references, bidirectional tags, and x-default fallbacks. Detects critical mistakes like missing return tags, invalid ISO codes (e.g. `eng` instead of `en`, `en-uk` instead of `en-GB`), and protocol mismatches that cause Google to ignore hreflang signals.

Generated from the current SKILL.md.

Does this skill work with HTTP headers and XML sitemaps, or just HTML tags?
It supports all three: HTML link tags, HTTP headers (for non-HTML files like PDFs), and XML sitemaps. Sitemap implementation is recommended for large sites with 50+ language variants.
What language and region codes does this skill validate?
It validates ISO 639-1 two-letter language codes (en, fr, de, ja) and ISO 3166-1 Alpha-2 region codes (US, GB, BR). It detects common errors like 'eng' instead of 'en', 'jp' instead of 'ja', and invalid region codes like 'en-uk'.
Does this skill check for bidirectional hreflang relationships?
Yes. It validates that hreflang relationships are bidirectional — if page A links to page B, page B must link back to page A. Missing return tags invalidate the hreflang signal for both pages.
Can this skill work with cross-domain hreflang setups?
Yes. It supports cross-domain hreflang (e.g., example.com and example.de) but requires return tags on both domains and recommends sitemap-based implementation for cross-domain configurations.
Does this skill assess content quality across language versions?
Yes. It includes a content parity audit that checks page existence, section structure, SEO elements, word count ratios, freshness, and cultural markers across all language versions. It also evaluates cultural adaptation for each locale against built-in profiles.

Generated from the current SKILL.md. These answers refresh after source changes.