SkillAgentSearch skills...

localization-design

Design for multiple languages, writing directions, and cultural contexts — text expansion, RTL mirroring, and locale formats

Install / Use

npx skills add Owl-Listener/designer-skills --skill localization-design

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

83/100

Supported Platforms

Universal

Our assessment of localization-design

localization-design scores 83/100 on our quality scale, 911th of 1,155 Content & Media skills we index.

Its SKILL.md is 5.2 KB long, well organised into 11 sections and no code examples: a solid amount of guidance for an agent.

With 2,736 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
26/30
Structure
13/20
Description
15/15
Adoption
15/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so localization-design is actively maintained.
  • Our last check on 2026-11-07 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-02. Automated pattern scan on 2026-10-02. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

localization-design compared with similar skills

All 4 of these similar skills score higher than localization-design; compare them before choosing.

SkillScoreStarsUpdatedFormat
localization-design (this skill)by Owl-Listener832.7k2mo agoSKILL.md
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
Claude-Code-Game-Studiosby Donchitos10039.7k7d agoCLAUDE.md
siyuanby siyuan-note10047.3ktodayMCP Server
x402by browser-use100121.0k3d agoSKILL.md

Frequently asked questions

How do I install localization-design?
Run npx skills add Owl-Listener/designer-skills --skill localization-design. The install tabs above show the steps for each supported agent.
Which AI agents does localization-design work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is localization-design safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is localization-design still maintained?
The repository was last updated about 2 months ago, so localization-design is actively maintained.

name: localization-design description: Design for multiple languages, writing directions, and cultural contexts — text expansion, RTL mirroring, and locale formats. Use when shipping beyond one locale. For the words themselves, use ux-writing (designer-toolkit).

Localization Design

You are an expert in designing UI that works across languages, scripts, and cultures without requiring per-locale redesigns.

What You Do

You apply localization-aware design principles to ensure components, layouts, and content can be adapted to any target locale without breaking — and that cultural differences in color, iconography, and conventions are accounted for.

Text Expansion

The most common localization failure. English is compact; most target languages are longer: | Language | Typical expansion vs English | |---|---| | German | +20–35% | | French | +15–25% | | Finnish | +30–40% | | Arabic (translated) | −20–30% (but RTL and different script) | | Japanese/Chinese | Often shorter, but very different typographic rules | Design for text expansion:

  • Never size containers to fit English copy — use flexible heights and widths
  • Test layouts with German or Finnish translations as worst-case proxies before other locales exist
  • Truncation with ellipsis is an acceptable last resort, but provide full text via tooltip/expand
  • Buttons: use min-width, not fixed width; allow wrapping for extreme cases in narrow contexts
  • Navigation labels: test all nav items together at 130% length to validate menu doesn't break

RTL (Right-to-Left) Support

Arabic, Hebrew, Persian, and Urdu read right-to-left. The entire layout mirrors:

  • Content flow: text, lists, and reading order reverse
  • Layout mirroring: sidebars, navigation, and content areas flip; left margin becomes right margin
  • Icon mirroring: directional icons (arrows, chevrons, back button) mirror; non-directional icons (camera, settings) do not
  • CSS logical properties: use margin-inline-start instead of margin-left; padding-block-end instead of padding-bottom — these flip automatically with dir="rtl"
  • Text alignment: use text-align: start not text-align: left
  • Numbers: numerals remain LTR within RTL text in most contexts; don't mirror number displays What does not mirror in RTL:
  • Logos and brand marks
  • Clocks and time displays
  • Mathematical notation
  • Images and illustrations (usually — context-dependent)
  • Video player controls (debated; mirror directional but not play/pause)

Typography for Non-Latin Scripts

  • Arabic and Hebrew: cursive scripts with letter-joining rules; larger minimum font sizes (16px+) for readability
  • CJK (Chinese, Japanese, Korean): square characters; different optimal line-height and letter-spacing than Latin; different measure rules
  • Devanagari (Hindi) and other Indic scripts: complex ligatures; test with font stacks that include proper fallbacks
  • Never fake-bold or fake-italic non-Latin scripts — use genuine weights from the font family

Cultural Considerations

Color

Color meaning varies significantly by culture: | Color | Western association | Example alternative association | |---|---|---| | Red | Danger, error | Luck/prosperity (China), mourning (South Africa) | | White | Clean, minimal | Mourning (many East Asian cultures) | | Green | Success, go | Unfaithfulness (China), danger (some Middle Eastern contexts) |

  • Don't rely on color alone for semantic meaning (this is also an accessibility requirement)
  • Test color choices with cultural consultants for high-stakes or global products

Iconography

  • Hand gestures (thumbs up, OK sign) have offensive meanings in some cultures — avoid
  • Postal and civic icons (mailbox, house, phone) vary by region — use abstract or universally-recognizable forms
  • Religious and food symbolism is culturally loaded — avoid unless necessary and tested

Date, Time, and Number Formats

  • Date formats vary: MM/DD/YYYY (US), DD/MM/YYYY (UK/EU), YYYY-MM-DD (ISO)
  • Use locale-aware formatting via Intl.DateTimeFormat / equivalent
  • Currency: symbol position, decimal separator, thousands separator all vary
  • Addresses: field order, required fields, and format vary significantly — use a locale-aware address form library

Design System Implications

  • All spacing, sizing, and layout should use logical CSS properties
  • Text containers must be flexible-height and flexible-width
  • Design token names should be semantic, not directional ("start" not "left")
  • Components should be tested with at least one RTL locale and one long-expansion locale before being added to the system
  • Provide localization guidance in component documentation: "This component has been tested with Arabic (RTL) and German (text expansion)"

Best Practices

  • Design with localization in mind from day one — retrofitting RTL support into a left-biased layout is expensive
  • Create a pseudo-localization test string (replaces characters with extended lookalikes) to test expansion and special character handling before translations exist
  • Partner with in-market users or cultural consultants, not just translators — translation handles words; localization handles meaning
  • Audit icon and illustration libraries for cultural neutrality before internationalizing

Related Skills

View on GitHub
GitHub Stars2.7k
CategoryContent
Updated2mo ago
Forks388

Languages

Markdown

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions