Skip to content

thisisAhsanIqbal/nextjs-seo-audit / skills/international-seo

international-seo

Verified

Validates hreflang tags, multi-language configuration, regional targeting, and internationalisation best practices. Use when auditing sites with multiple languages, regions, or localised content.

International SEO

Audit the page for multi-language and regional targeting issues.

When to activate: Only relevant if the site serves multiple languages, regions, or has localised content. If a page is monolingual with no internationalisation signals, report ✅ PASS "No internationalisation issues (single-language site)".

1. Hreflang tags

Look for <link rel="alternate" hreflang="..."> in <head>:

CheckStatus
No hreflang tags on a multi-language site❌ FAIL "Add hreflang tags to indicate language/region variants"
Hreflang tags present✅ PASS — list all language-region codes found

Hreflang validation rules

RuleViolation =
Self-referencing hreflang missing (page must include itself)❌ FAIL
x-default fallback missing⚠️ WARN "Add hreflang=\"x-default\" for the default/fallback page"
Invalid language code (must be ISO 639-1, e.g. en, fr, de)❌ FAIL
Invalid region code (must be ISO 3166-1 alpha-2, e.g. en-US, fr-CA)⚠️ WARN
Hreflang URLs return 4xx or 5xx❌ FAIL "Hreflang points to broken URL"
Duplicate hreflang entries for same language-region⚠️ WARN

2. HTML lang attribute

CheckStatus
<html lang="..."> missing❌ FAIL
lang value doesn't match hreflang self-reference⚠️ WARN "Mismatch between html lang and hreflang"
Properly set✅ PASS

3. Content-Language header (meta)

  • <meta http-equiv="Content-Language" content="..."> → check if present
  • If present, verify it matches the lang attribute → ⚠️ WARN if mismatch

4. URL structure for internationalisation

Detect URL pattern used:

PatternExampleAssessment
Subdirectory/en/, /fr/, /de/✅ Recommended
Subdomainen.example.com✅ Acceptable
ccTLDexample.fr, example.de✅ Strong geo-targeting
URL parameter?lang=en⚠️ WARN "Not recommended — search engines may ignore parameters"

5. Translated content checks

CheckStatus
Page has lang="en" but content appears in another language⚠️ WARN "Language mismatch detected"
<title> and <meta description> not translated (same across language variants)⚠️ WARN
Images with alt text not translated⚠️ WARN

6. Regional targeting

  • Check for <meta name="geo.region">, <meta name="geo.placename">, <meta name="geo.position"> → ✅ PASS if present
  • Google Search Console geographic targeting hint: check for <link rel="canonical"> pointing to regional variant

Edge cases

  • A monolingual site with no internationalisation signals → skip all checks, report "Not applicable"
  • A site with hreflang on some pages but not others → flag inconsistency
  • Right-to-left languages (Arabic, Hebrew) → check for dir="rtl" attribute on <html> or <body>
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall