본문으로 건너뛰기
cccskills
무료GitHub에 공개

localization-design

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).

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

설치 방법 보기

포함된 파일(1)

  • SKILL.md5.2 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

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:

LanguageTypical expansion vs English
German+20–35%
French+15–25%
Finnish+30–40%
Arabic (translated)−20–30% (but RTL and different script)
Japanese/ChineseOften 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:

ColorWestern associationExample alternative association
RedDanger, errorLuck/prosperity (China), mourning (South Africa)
WhiteClean, minimalMourning (many East Asian cultures)
GreenSuccess, goUnfaithfulness (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

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

Design an A/B experiment — hypothesis, variants, primary metric, and sample size. Use when a change can be measured quantitatively at scale. For observing behaviour qualitatively, use `test-scenario`.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

Owl-Listener/designer-skills3천2026년 9월 6일 업데이트

Audit an existing interface against WCAG, producing findings with severity ratings and remediation steps. Use when you have a design or build to assess now. Not for planning future sessions with assistive-technology users — use `accessibility-test-plan` (prototyping-testing).

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

Owl-Listener/designer-skills3천2026년 9월 6일 업데이트

Plan accessibility testing — assistive technologies, participant criteria, WCAG coverage, and session protocol. Use when scheduling testing with real AT users. Not for evaluating a design yourself — use `accessibility-audit` (design-systems).

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

Owl-Listener/designer-skills3천2026년 9월 6일 업데이트

Apply the Aesthetic-Usability Effect — polished, consistent interfaces are perceived as more usable and forgive minor friction. Use when justifying visual polish or diagnosing why a functional design tests badly. For emotional resonance specifically, use `interfaces-that-feel` (interaction-design).

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

Owl-Listener/designer-skills3천2026년 9월 6일 업데이트

Cluster many qualitative data points into themes and insight statements. Use when synthesising across multiple sessions or sources. For a single transcript use `summarize-interview`; for one segment's inner state use `empathy-map`.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

Owl-Listener/designer-skills3천2026년 9월 6일 업데이트

Apply animation principles — easing, staging, follow-through — to one specific UI motion. Use when tuning how an animation feels. For product-wide duration and easing tokens use `motion-system` (design-systems); for a full interaction spec use `micro-interaction-spec`.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

Owl-Listener/designer-skills3천2026년 9월 6일 업데이트

Owl-Listener의 스킬 모두 보기

이 스킬의 문제 신고