international-seo
Skill5 starsChanged 38 days agoMITView on GitHub
Audit and configure multi-language and multi-regional websites including hreflang reciprocity, x-default fallbacks, HTML lang declarations, and locale canonicalization.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- MYehia565/google-seo-agent-skillstheir own version, first seen Oct 13, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- MYehia565/google-seo-agent-skills★ 1same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository24 other files it gives its agents.
- one-step-seoSkill
- accessibility-seoSkill
- answer-engine-optimizationSkill
- content-qualitySkill
- core-web-vitalsSkill
- duplicate-contentSkill
- ecommerce-seoSkill
- entity-optimizationSkill
- geo-optimizationSkill
- http-statusSkill
- image-seoSkill
- internal-linkingSkill
- javascript-seoSkill
- llms-txtSkill
- local-seoSkill
- onpage-optimizationSkill
- schema-validationSkill
- security-hygieneSkill
- seo-auditSkill
- seo-fixSkill
- seo-regressionSkill
- sitemap-robotsSkill
- social-metadataSkill
- technical-seoSkill
The file
We split this skill into the rules it gives an agent
8 rules. About 0 are common, 0 are distinctive, and 8 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈0
Distinctive · estimate
This author's own choices. Worth a look.
8
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 15
Run a focused localization audit via --skills international-seo.
- Very specific: line 29
Ensure every HTML document declares a valid BCP-47 <html lang="..."> attribute (T09-lang P2 when missing) matching the visible language of …
- Very specific: line 31
Check <link rel="alternate" hreflang="..." href="..."> tags (W03-hreflang P3 when any entry lacks a valid hreflang or href).
- Very specific: line 33
Self-referencing
hreflang: Every localized page includes an hreflang link pointing to itself. - Very specific: line 34
Reciprocity (return links): If /en/pricing links to /de/pricing, /de/pricing must link back to /en/pricing.
- Very specific: line 36
Absolute canonical URLs: Every href in hreflang must be an absolute https:// URL returning HTTP 200.
- Very specific: line 75
Never guess <html lang> when running one-step-seo fix — always pass an explicit --lang <bcp47> verified from the page's actual language.
- Very specific: line 76
Never redirect crawlers (Googlebot, GPTBot, ClaudeBot) automatically by GeoIP (Accept-Language or IP geolocation 302 redirects), because …
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
international-seo — Internationalization & Multi-Regional SEO
1. Description & Activation Criteria
Activate international-seo when the user wants to:
- Audit multi-language or multi-country sites (
en,en-US,en-GB,fr-CA,es,de,ja, etc.) forhreflangcompleteness and<html lang>alignment. - Diagnose why the wrong regional or translated URL ranks in Google or gets cited by AI search engines.
- Remediate
W03-hreflang(P3),T09-lang(P2), or cross-locale canonical mistakes (T08-canonicalP1/P2). - Run a focused localization audit via
--skills international-seo.
2. Inputs & Prerequisites
- Target: Live regional URL(s) or local multi-locale build directory (e.g.,
./dist/en/,./dist/fr/). - Optional flags:
--skills international-seo: Focuses findings onW03-hreflang,T09-lang,T08-canonical, andS02-schema checks.--pages N: Audits multiple locale variants in a single run to verify each locale self-canonicalizes rather than pointing all translations to the default language.
3. Step-by-Step Workflow
- Run an internationalization-scoped audit:
- Execute
npx one-step-seo page <url> --skills international-seo --out ./seo-report(ornpx one-step-seo audit <url> --pages 15 --skills international-seo --out ./seo-report).
- Execute
- Verify document language declaration (
T09-lang):- Ensure every HTML document declares a valid BCP-47
<html lang="...">attribute (T09-langP2 when missing) matching the visible language of the page.
- Ensure every HTML document declares a valid BCP-47
- Validate
hreflangalternate links (W03-hreflang):- Check
<link rel="alternate" hreflang="..." href="...">tags (W03-hreflangP3 when any entry lacks a validhreflangorhref). - Confirm four localization invariants:
- Self-referencing
hreflang: Every localized page includes anhreflanglink pointing to itself. - Reciprocity (return links): If
/en/pricinglinks to/de/pricing,/de/pricingmust link back to/en/pricing. x-defaultfallback: Includehreflang="x-default"pointing to the language selector or global default URL.- Absolute canonical URLs: Every
hrefinhreflangmust be an absolutehttps://URL returning HTTP200.
- Self-referencing
- Check
- Prevent cross-locale canonical cannibalization (
T08-canonical):- Inspect
report.page.canonicalvsreport.finalUrl. Translated pages (/fr/...,/es/...) must self-canonicalize to their own locale URL — never canonicalize a French translation to the English URL, or Google will de-index the translated page.
- Inspect
4. Tools & CLI Commands
# Single-page international SEO audit
npx one-step-seo page https://example.com/fr/pricing --skills international-seo --out ./seo-report
# Multi-page crawl across localized subdirectories
npx one-step-seo audit https://example.com --pages 20 --skills international-seo --out ./seo-report
# Safe dry-run fix for missing <html lang> on a localized build directory
npx one-step-seo fix ./dist/fr --only lang --lang fr
# Inspect the international-local skill definition
npx one-step-seo skills international-seo5. Evidence Requirements
- Quote
T09-langandW03-hreflangevidencestrings fromreport.findings. - Report
report.finalUrlalongsidereport.page.canonicalfor every audited locale variant to prove each locale self-canonicalizes. - List the exact ISO 639-1 language codes (e.g.,
en,es,fr) and optional ISO 3166-1 Alpha-2 region codes (e.g.,en-GB,pt-BR— neveren-UK, which is invalid ISO 3166-1).
6. Expected Outputs
- Locale & Hreflang Matrix: Table of audited URLs,
<html lang>,report.page.canonical, declaredhreflangcluster, andx-defaulttarget. - Canonical & Reciprocity Diagnosis: Any broken return links, invalid region codes (
en-UKvsen-GB), or cross-language canonical errors. - Ready-to-Paste
<head>Cluster: Complete<link rel="alternate" hreflang="...">+<link rel="canonical">block for each locale.
7. Limitations & External Data
- Single-page vs cross-domain reciprocity:
W03-hreflangverifies syntax and completeness of<link rel="alternate" hreflang>tags on each audited page; verifying bidirectional reciprocity across separate country-code TLDs (.co.uk,.de,.jp) requires auditing each target URL separately withone-step-seo page. - Offline support: 100% supported on local static exports (
--offline).
8. Safety & Approval Rules
- Never guess
<html lang>when runningone-step-seo fix— always pass an explicit--lang <bcp47>verified from the page's actual language. - Never redirect crawlers (
Googlebot,GPTBot,ClaudeBot) automatically by GeoIP (Accept-Languageor IP geolocation302redirects), because US-based crawlers will never see non-US regional pages; usehreflang+ a user-selectable locale switcher instead.
9. Examples
# Audit an offline multi-locale static build
npx one-step-seo audit ./dist --pages 20 --skills international-seo --offline --out ./seo-report
# Apply explicit French lang attribute with backup safety
npx one-step-seo fix ./dist/fr/index.html --apply --only lang --lang fr-FRDoes it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

