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.

referencescontent-parity.md

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

Content Parity Audit for Multi-Language Sites

Load this reference when auditing content parity across language versions of a site. Content parity ensures all language versions provide equivalent value and SEO signals.

Original concept: Chris Muller (Pro Hub Challenge)

Content Parity Matrix

For each page that exists in multiple languages, check:

Dimension What to Compare Acceptable Variance Severity if Failing
Page existence Does equivalent page exist in all declared languages? 0%: all declared languages must have the page High
Section structure Same number of H2/H3 sections? ±1 section allowed Medium
FAQ items Same number of FAQ questions? ±2 items allowed Medium
Images Same number of images with localized alt text? Must match exactly Medium
Charts/SVGs Charts present in all versions? Must match exactly Low
Word count Proportional to language expansion ratio? ±30% of expected ratio Low
Schema markup JSON-LD present and localized in all versions? Must match type and key properties High
Title tag Localized with target keyword in local language? Must be localized, not English High
Meta description Localized and within character limits? Must be localized Medium

Freshness Tracking

Detect stale translations by comparing:

  1. File modification timestamps: If EN version was updated after DE version, DE may be stale
  2. Frontmatter dates: Compare date_modified or lastmod across language versions
  3. Content hash comparison: If the source language content hash changed since last translation

Freshness delta thresholds:

  • Fresh: Translated within 7 days of source update → OK
  • Aging: 8-30 days since source update → Low priority update
  • Stale: 31-90 days since source update → Medium priority update
  • Outdated: 90+ days since source update → High priority update

Word Count Ratio Validation

Expected word count ratios vs English source:

Target Language Expected Ratio Acceptable Range
German (DE) 1.25-1.35x 1.10-1.50x
French (FR) 1.15-1.25x 1.00-1.40x
Spanish (ES) 1.15-1.25x 1.00-1.40x
Japanese (JA) 0.75-0.90x 0.60-1.00x
Chinese (ZH) 0.70-0.80x 0.55-0.95x

A German translation that is shorter than the English original likely has missing content. A Japanese translation that is longer than English likely has unnecessary padding.

Cultural Adaptation Quality Gates

Beyond direct translation, check for cultural markers that indicate proper localization:

Check What to Look For Severity
Foreign brand references US-specific brands on non-US pages (e.g., "Walmart" on de-DE) Medium
Foreign statistics US-only data cited on localized pages (e.g., "80% of Americans") Medium
CTA aggressiveness Aggressive CTAs on formal-culture pages (e.g., "BUY NOW!" on ja-JP) Low
Legal references Wrong jurisdiction laws cited (e.g., CCPA on de-DE instead of DSGVO) High
Currency/unit mismatch USD prices on EUR pages, imperial units on metric pages High
Untranslated elements English text remaining in navigation, buttons, alt text, schema Medium

Parity Score Calculation

Score out of 100:

  • Page existence parity: 30 points
  • SEO element parity (title, meta, schema): 30 points
  • Content structure parity (sections, images, FAQ): 25 points
  • Freshness parity: 15 points

Interpretation:

  • 90-100: Excellent parity across all language versions
  • 70-89: Good parity with minor gaps to address
  • 50-69: Significant parity issues affecting some language versions
  • Below 50: Major parity failures requiring immediate attention

Output Format

Present as a matrix table:

| Page | EN | DE | FR | ES | JA | Parity Score |
|------|----|----|----|----|----| -------------|
| /about | ✅ | ✅ | ✅ | ❌ | ✅ | 80/100 |
| /pricing | ✅ | ✅ | ⚠️ | ❌ | ❌ | 45/100 |

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.