Installable AI agent skill for auditing, planning, localizing, and verifying multilingual websites—with technical SEO signals (hreflang, canonicals, sitemaps, schema, analytics) and a proper translation playbook.
Not a SaaS product. Not a hosted TMS. No paid API required for the core offline workflow.
- Agent entrypoint:
SKILL.md+skill.json - Deep docs: SEO checklist, translation playbook, locale architecture, framework adapters
- Offline Python 3.11+ checkers over
dist/HTML - Schemas, checklists, prompts, and templates you can drop into any repo
- A ranking guarantee
- A substitute for qualified legal review
- Permission to invent testimonials, certifications, or stats
- An excuse for geo-IP /
Accept-Languageforce redirects
git clone https://github.com/adamgrgs/i18n-agent.git .cursor/skills/multilingual-i18n-seo
# or: git submodule add https://github.com/adamgrgs/i18n-agent.git .cursor/skills/multilingual-i18n-seoPoint project rules / AGENTS.md at .cursor/skills/multilingual-i18n-seo/SKILL.md.
Details: docs/install-cursor.md
mkdir -p .claude/skills
git clone https://github.com/adamgrgs/i18n-agent.git .claude/skills/multilingual-i18n-seoAdd a pointer in CLAUDE.md. Details: docs/install-claude-code.md
Clone into skills/multilingual-i18n-seo and @ / mention SKILL.md or AGENTS.md.
Details: docs/install-generic.md
Trigger phrases:
- “Use the multilingual i18n SEO skill to audit this repo”
- “Plan fr-CA + es localization with proper hreflang”
- “Translate marketing pages using the translation playbook”
- “Add CI checks for multilingual SEO”
Discover → Plan → Technical SEO → Translate → Verify
- Audit — follow
prompts/audit.md; use the checklist indocs/multilingual-seo-checklist.md. - Plan — produce
locale-registry.jsonfromtemplates/locale-registry.example.json. - Implement SEO signals —
prompts/implement-technical-seo.md+docs/framework-adapters.md. - Translate —
docs/translation-playbook.md(localize / transcreate / adapt—don’t calque). - Verify:
python scripts/validate_locale_registry.py templates/locale-registry.example.json
python scripts/check_i18n_seo.py \
--root dist \
--registry path/to/locale-registry.json \
--sitemap dist/sitemap-0.xml \
--format bothSample checker output: examples/sample-audit-report.md
Requires Python 3.11+. Core scripts use the standard library only.
pip install -r scripts/requirements.txt # pytest for tests
python -m pytest tests/ -q
# or: python -m unittest discover -s tests -p 'test_*.py' -v| Script | Purpose |
|---|---|
scripts/check_i18n_seo.py |
HTML/dist/ audit (title, canonical, og:url, lang, hreflang, noindex rules, sitemap) |
scripts/validate_locale_registry.py |
Registry structure validation |
scripts/validate_hreflang.py |
Reciprocity / casing checks |
scripts/extract_translatables.py |
Best-effort string inventory helper |
CI template: templates/github-actions-seo-check.yml
See the tree in the skill brief; key paths:
SKILL.md— agent control planedocs/— depthprompts/— phase promptschecklists/— machine-readable gatesschemas/— JSON schemastemplates/— copy-paste startersscripts/— offline checkerstests/— fixtures + unit tests
- No geo-IP /
Accept-Languageauto-redirects as default - Don’t change locked third-party booking/profile URLs unless the user pastes a replacement
- Don’t emit hreflang on noindex / 404 / placeholders
- Don’t advertise two public sitemap entrypoints
- Don’t calque English keyword maps
- Don’t drop live locales from hreflang while pages stay indexable
- Keep
SKILL.mdlean; put depth indocs/. - Add fixtures when introducing new checker rules.
- Run
python -m pytest tests/ -qbefore submitting. - Follow MIT licensing; avoid paid API hard dependencies.
Agents can err. Legal and jurisdiction-specific pages need human (often qualified legal) review. SEO outcomes are not guaranteed. This software is provided under the MIT License as is—see LICENSE.
MIT © 2026 Multilingual i18n SEO Skill Contributors