build-a-localization-routing-strategy

Build a localization routing strategy for stable URLs, locale negotiation, alternates, fallbacks, indexing, persistence, and migration. Use when a website serves multiple languages, countries, scripts, or regional content variants.

Jump to install

Repository: protosphinx/sphinxstack
Last source activity: July 29, 2026 at 13:55
Detected SKILL.md language: English
Stars: 1
Forks: 0

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/protosphinx/sphinxstack --skill build-a-localization-routing-strategy

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

2 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

build-a-localization-routing-strategy

Keep content identity stable and make locale choice reversible.

When to use

Use for new multilingual sites, URL redesigns, market launches, or localization defects.

Do not force a locale solely from inferred location when users need another language or market.

Procedure

Inventory languages, scripts, regions, legal variants, translation coverage, domains, paths, query patterns, and legacy URLs.

Choose a canonical URL model and document whether language, region, or both determine content identity.

Define first-visit negotiation from explicit choice, saved preference, account setting, browser language, and location in that priority.

Provide a visible selector that preserves the equivalent page, accepts keyboard and assistive technology, and stores minimal preference.

Specify missing-translation fallback without silently changing regulated terms, prices, availability, or market context.

Map canonical, alternate-language, default, sitemap, redirect, and indexing behavior.

Preserve query, campaign, authentication, and safe navigation state across locale changes.

Test bots, users, logged-in transitions, shared URLs, unsupported locales, mixed scripts, right-to-left layout, and cache variation.

Migrate legacy routes with one-hop redirects and monitor wrong-locale landings and crawl signals.

Done

A localization routing plan records URL identity, negotiation priority, selector behavior, fallback, alternates, caching, and migration maps

Locale, bot, canonical, redirect, equivalent-page, accessibility, cache, and indexing tests verify every supported variant

name	build-a-localization-routing-strategy
category	web
description	Build a localization routing strategy for stable URLs, locale negotiation, alternates, fallbacks, indexing, persistence, and migration. Use when a website serves multiple languages, countries, scripts, or regional content variants.