Communitygithub.com

Infrasity-Labs/dev-gtm-claude-skills

다국어, 다양한 문자 체계 및 문화적 맥락에 유연하게 적응하는 인터페이스를 설계합니다.

dev-gtm-claude-skills란 무엇인가요?

이 스킬은 UI 디자이너와 개발자가 지역화(l10n)를 고려한 적응형 인터페이스를 설계할 수 있도록 지원합니다. 텍스트 확장, RTL(오른쪽에서 왼쪽) 레이아웃, 비라틴 문자 타이포그래피, 색상 및 아이콘의 문화적 차이 등 지역화 실패의 주요 원인을 사전에 방지하는 원칙을 제공합니다. CSS 논리 속성 사용, 컴포넌트의 유연한 크기 조정, 문화 컨설턴트와의 협업 등 실용적인 모범 사례를 포함합니다. Claude Code, Cursor, Codex 등 모든 AI 에이전트 플랫폼에서 지역화 친화적인 디자인 시스템을 구축하고자 하는 개발자에게 필수적인 가이드입니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Infrasity-Labs/dev-gtm-claude-skills/tree/HEAD/.claude/skills/localization-design

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

지역화 디자인

당신은 언어, 문자 체계 및 문화를 아우르는 UI를 설계하는 전문가입니다. 각 로케일별로 재설계할 필요 없이 작동하는 인터페이스를 만듭니다.

수행 업무

컴포넌트, 레이아웃 및 콘텐츠가 대상 로케일에 맞게 조정될 때 깨지지 않도록 지역화 인식 디자인 원칙을 적용합니다. 또한 색상, 아이콘 및 관습의 문화적 차이를 고려합니다.

텍스트 확장

가장 흔한 지역화 실패 원인입니다. 영어는 간결하지만 대부분의 대상 언어는 더 깁니다.

언어영어 대비 일반적인 확장률
독일어+20–35%
프랑스어+15–25%
핀란드어+30–40%
아랍어 (번역)−20–30% (하지만 RTL 및 다른 문자 체계)
일본어/중국어종종 더 짧지만 타이포그래피 규칙이 매우 다름

텍스트 확장을 위한 설계:

  • 컨테이너 크기를 영어 텍스트에 맞게 고정하지 말고 유연한 높이와 너비를 사용하세요.
  • 다른 로케일이 생기기 전에 독일어 또는 핀란드어 번역을 최악의 경우 프록시로 사용하여 레이아웃을 테스트하세요.
  • 줄임표를 사용한 생략은 최후의 수단으로 허용되지만, 툴팁이나 확장을 통해 전체 텍스트를 제공하세요.
  • 버튼: 고정 너비 대신 min-width를 사용하고, 좁은 컨텍스트에서 극단적인 경우 줄바꿈을 허용하세요.
  • 탐색 레이블: 모든 탐색 항목을 130% 길이로 함께 테스트하여 메뉴가 깨지지 않는지 확인하세요.

RTL(오른쪽에서 왼쪽) 지원

아랍어, 히브리어, 페르시아어, 우르두어는 오른쪽에서 왼쪽으로 읽습니다. 전체 레이아웃이 미러링됩니다.

  • 콘텐츠 흐름: 텍스트, 목록 및 읽기 순서가 반전됩니다.
  • 레이아웃 미러링: 사이드바, 탐색 및 콘텐츠 영역이 반전되며, 왼쪽 여백이 오른쪽 여백이 됩니다.
  • 아이콘 미러링: 방향 아이콘(화살표, 쉐브론, 뒤로 가기 버튼)은 미러링되지만, 비방향 아이콘(카메라, 설정)은 미러링되지 않습니다.
  • CSS 논리 속성: margin-left 대신 margin-inline-start, padding-bottom 대신 padding-block-end를 사용하세요. 이 속성들은 dir="rtl"로 자동으로 반전됩니다.
  • 텍스트 정렬: text-align: left 대신 text-align: start를 사용하세요.
  • 숫자: 대부분의 컨텍스트에서 RTL 텍스트 내에서 숫자는 LTR로 유지됩니다. 숫자 표시를 미러링하지 마세요.

RTL에서 미러링되지 않는 것:

  • 로고 및 브랜드 마크
  • 시계 및 시간 표시
  • 수학 표기법
  • 이미지 및 일러스트레이션 (일반적으로 컨텍스트에 따라 다름)
  • 비디오 플레이어 컨트롤 (논쟁의 여지가 있음, 방향성은 미러링하지만 재생/일시 정지는 미러링하지 않음)

비라틴 문자 타이포그래피

  • 아랍어 및 히브리어: 문자 결합 규칙이 있는 필기체, 가독성을 위해 더 큰 최소 글꼴 크기(16px 이상) 필요
  • CJK(중국어, 일본어, 한국어): 정사각형 문자, 라틴 문자와 다른 최적의 줄 높이 및 자간, 다른 측정 규칙
  • 데바나가리(힌디어) 및 기타 인도 문자: 복잡한 합자, 적절한 대체 글꼴을 포함하는 글꼴 스택으로 테스트
  • 비라틴 문자를 가짜 볼드체나 가짜 이탤릭체로 표시하지 말고 글꼴 패밀리에서 실제 굵기를 사용하세요.

문화적 고려 사항

색상

색상의 의미는 문화에 따라 크게 다릅니다.

색상서양 연관성예시 대체 연관성
빨간색위험, 오류행운/번영 (중국), 애도 (남아프리카)
흰색깨끗함, 미니멀애도 (많은 동아시아 문화)
녹색성공, 진행불신 (중국), 위험 (일부 중동 컨텍스트)
  • 의미 전달에 색상만 사용하지 마세요. (접근성 요구 사항이기도 함)
  • 중요도가 높거나 글로벌 제품의 경우 문화 컨설턴트와 함께 색상 선택을 테스트하세요.

아이콘

  • 손 제스처(엄지척, OK 사인)는 일부 문화에서 공격적인 의미를 가질 수 있으므로 피하세요.
  • 우편 및 시민 아이콘(우편함, 집, 전화)은 지역에 따라 다르므로 추상적이거나 보편적으로 인식 가능한 형태를 사용하세요.
  • 종교 및 음식 상징은 문화적으로 민감하므로 필요하고 테스트된 경우가 아니면 피하세요.

날짜, 시간 및 숫자 형식

  • 날짜 형식: MM/DD/YYYY (미국), DD/MM/YYYY (영국/유럽), YYYY-MM-DD (ISO)
  • Intl.DateTimeFormat / 동등한 방법을 사용하여 로케일 인식 형식 사용
  • 통화: 기호 위치, 소수 구분 기호, 천 단위 구분 기호가 모두 다름
  • 주소: 필드 순서, 필수 필드 및 형식이 크게 다르므로 로케일 인식 주소 양식 라이브러리 사용

디자인 시스템 영향

  • 모든 간격, 크기 및 레이아웃은 CSS 논리 속성을 사용해야 합니다.
  • 텍스트 컨테이너는 유연한 높이와 너비여야 합니다.
  • 디자인 토큰 이름은 의미론적이어야 하며 방향성을 나타내지 않아야 합니다. ("left"가 아닌 "start")
  • 시스템에 추가되기 전에 컴포넌트를 최소 하나의 RTL 로케일과 하나의 긴 확장 로케일로 테스트해야 합니다.
  • 컴포넌트 문서에 지역화 지침을 제공하세요. "이 컴포넌트는 아랍어(RTL) 및 독일어(텍스트 확장)로 테스트되었습니다."

모범 사례

  • 처음부터 지역화를 염두에 두고 설계하세요. 왼쪽 중심 레이아웃에 RTL 지원을 나중에 추가하는 것은 비용이 많이 듭니다.
  • 번역이 있기 전에 확장 및 특수 문자 처리를 테스트하기 위해 의사 지역화 테스트 문자열(문자를 확장된 유사 문자로 대체)을 만드세요.
  • 번역가뿐만 아니라 현지 사용자나 문화 컨설턴트와 협력하세요. 번역은 단어를 처리하고 지역화는 의미를 처리합니다.
  • 국제화 전에 아이콘 및 일러스트레이션 라이브러리의 문화적 중립성을 감사하세요.

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

Infrasity-Labs/dev-gtm-claude-skills

Translate existing blog posts into one or more target languages with SEO-optimized localization. Produces native-quality translations that preserve markdown structure, frontmatter, schema JSON-LD, image and chart embeds, and citation capsules. Localizes keywords, meta tags, numbers, dates, currencies, and quote styles per locale. Flags machine-translation artifacts for review. Run BEFORE blog-localize: this handles language conversion; localize handles cultural adaptation after translation completes. Use when user says "translate blog", "blog translate", "uebersetzen", "traduire", "traducir", "translate post", "blog auf Deutsch", "blog en espanol".

Infrasity-Labs/dev-gtm-claude-skills

Balance visual design with ATS compatibility for creative roles

Infrasity-Labs/dev-gtm-claude-skills

Apply Fitts's Law to size and position interactive targets for fast, accurate interaction.

Infrasity-Labs/dev-gtm-claude-skills

When the user wants to plan a product launch, feature announcement, or release strategy. Also use when the user mentions 'launch,' 'Product Hunt,' 'feature release,' 'announcement,' 'go-to-market,' 'beta launch,' 'early access,' 'waitlist,' 'product update,' 'how do I launch this,' 'launch checklist,' 'GTM plan,' or 'we're about to ship.' Use this whenever someone is preparing to release something publicly. For ongoing marketing after launch, see marketing-ideas.

Infrasity-Labs/dev-gtm-claude-skills

Create platform-specific social media posts for LinkedIn, Facebook, Instagram, and Reddit. Handles character limits, hashtag strategies, hook placement, and image specs per platform. Works from scratch, from existing content (blog, newsletter, announcement), or as a multi-platform campaign. Produces copy-paste-ready posts. Triggers: 'social media post', 'linkedin post', 'facebook post', 'instagram caption', 'reddit post', 'social posts', 'post to social', 'repurpose for social', 'social media campaign'.

Infrasity-Labs/dev-gtm-claude-skills

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

Infrasity-Labs/dev-gtm-claude-skills

Transform resume bullets into detailed portfolio case studies

Infrasity-Labs/dev-gtm-claude-skills

Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.

Infrasity-Labs/dev-gtm-claude-skills

Audits any landing or service page across 48 checks in 10 categories for LLM/AI discoverability, GEO readiness, content clarity, schema markup, internal linking, freshness signals, and technical crawlability. Produces an overall score out of 100, a per-category score out of 100, pass/warn/fail/ manual counts, and a prioritised fix list — all rendered as a standalone HTML report saved to disk. Use when a user provides a URL and asks to audit it, score it, check its GEO readiness, test its AI discoverability, run a landing page audit, or evaluate it for LLM citation potential. Also trigger on phrases like "audit this page", "score this URL", "check GEO for", "is this page AI-ready", "run a GEO audit", "LLM page check", "how would AI read this page", or "landing page score".

관련 스킬