Communitygithub.com

i18n & Localization

국제화(i18n) 및 지역화(L10n) 워크플로 스킬입니다. 하드코딩된 문자열 탐지, 번역 관리, 로케일 파일, RTL 지원 등이 필요할 때 사용하며, 업스트림 워크플로, 복사된 지원 파일, 출처(provenance)를 병합 또는 인계 전에 보존해야 합니다.

i18n & Localization란 무엇인가요?

이 스킬은 오픈소스 리포지토리 `antigravity-awesome-skills`의 `i18n-localization` 디렉토리를 Omni Skills 플랫폼으로 가져와 사용하는 국제화 및 지역화 워크플로입니다. 주된 목적은 업스트림 워크플로와 출처를 명시적으로 유지하면서, 하드코딩된 문자열 탐지, 로케일 파일 구조, RTL 지원, 번역 키 관리 등 i18n/L10n 모범 사례를 제공하는 것입니다. `metadata.json`의 `external_source` 블록과 `ORIGIN.md` 파일을 통해 출처 추적을 보장하며, `scripts/i18n_checker.py`와 같은 도구를 통해 프로젝트에서 하드코딩된 문자열 및 누락된 번역을 감지할 수 있습니다. 이 스킬은 React, Next.js, Python 등 다양한 프레임워크에 적용 가능한 구현 패턴과 체크리스트를 포함하여 개발자가 국제화와 지역화 작업을 체계적으로 수행할 수 있도록 돕습니다.

지원 대상✓Claude Code✓Codex CLI✓Cursor✓Antigravity✓Gemini CLI✓OpenCode
npx skills add https://github.com/diegosouzapw/awesome-omni-skills/tree/HEAD/skills/i18n-localization-v2

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

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

문서

i18n & Localization은(는) 무엇을 하나요?

개요

이 공개 인트레이크 복사본은 https://github.com/sickn33/antigravity-awesome-skills의 plugins/antigravity-awesome-skills/skills/i18n-localization 패키지를 Omni Skills 편집 형식으로 포장하면서 원본 출처를 숨기지 않습니다.

운영자가 업스트림 워크플로, 지원 파일, 리포지토리 컨텍스트를 그대로 유지하면서 공개 유효성 검사기와 비공개 강화기가 정상적인 다운스트림 흐름을 계속하도록 해야 할 때 사용하세요.

이 인트레이크는 복사된 업스트림 파일을 그대로 유지하고 metadata.json의 external_source 블록과 ORIGIN.md를 리뷰를 위한 출처 앵커로 사용합니다.

i18n & Localization > 국제화(i18n) 및 지역화(L10n) 모범 사례

공개 제목에 깔끔하게 매핑되지 않은 가져온 소스 섹션은 아래 또는 지원 파일에 그대로 보존됩니다. 눈에 띄는 가져온 섹션: 1. 핵심 개념, 3. 구현 패턴, 4. 파일 구조, 6. 일반적인 문제, 7. RTL 지원, 8. 체크리스트.

이 스킬을 사용해야 할 때

이 섹션을 트리거 필터로 사용하세요. 운영자가 파일을 로드하거나, 명령을 실행하거나, 풀 리퀘스트를 열기 전에 활성화 경계를 명시적으로 만들어야 합니다.

  • 프로젝트 유형 - i18n 필요?
  • 공개 웹 앱 - ✅ 필요
  • SaaS 제품 - ✅ 필요
  • 내부 도구 - ⚠️ 가능성 있음
  • 단일 지역 앱 - ⚠️ 향후 고려
  • 개인 프로젝트 - ❌ 선택 사항

운영 테이블

상황시작 위치중요한 이유
첫 사용metadata.json복사된 워크플로를 건드리기 전에 external_source 블록을 통해 리포지토리, 브랜치, 커밋, 가져온 경로 확인
출처 리뷰ORIGIN.md리뷰어에게 가져온 소스에 대한 일반 언어 감사 추적 제공
워크플로 실행scripts/i18n_checker.py실행을 실질적으로 변경하는 가장 작은 복사 파일로 시작
지원 컨텍스트scripts/i18n_checker.py전체 패키지를 로드하지 않고 다음으로 관련성이 높은 복사 소스 파일 추가
인계 결정## 관련 스킬작업이 다른 영역으로 이동할 때 더 강력한 네이티브 스킬로 전환 지원

워크플로

이 워크플로는 편집 및 운영 목적을 동시에 가집니다. 가져온 소스를 운영자에게 유용하게 유지하면서 다운스트림 강화기 흐름을 공급하는 공개 인트레이크 표준을 충족시킵니다.

  1. 사용자 목표, 가져온 워크플로의 범위, 이 스킬이 여전히 작업에 적합한 라우터인지 확인합니다.
  2. 복사된 업스트림 지원 파일을 로드하기 전에 개요 및 출처 파일을 읽습니다.
  3. 현재 요청의 결과를 실질적으로 변경하는 참조, 예제, 프롬프트 또는 스크립트만 로드합니다.
  4. 작업 노트에 출처 및 소스 경계를 명시적으로 유지하면서 업스트림 워크플로를 실행합니다.
  5. 업스트림 기대치와 복사된 파일에서 지적할 수 있는 증거를 기준으로 결과를 검증합니다.
  6. 작업이 이 가져온 워크플로의 중심 범위를 벗어나면 관련 스킬로 에스컬레이션하거나 인계합니다.
  7. 병합 또는 종료 전에 사용된 내용, 변경된 내용, 리뷰어가 여전히 확인해야 할 사항을 기록합니다.

가져온 워크플로 노트

가져옴: 1. 핵심 개념

용어의미
i18n국제화 - 앱을 번역 가능하게 만들기
L10n지역화 - 실제 번역
Locale언어 + 지역 (en-US, tr-TR)
RTL오른쪽에서 왼쪽 언어 (아랍어, 히브리어)

예제

예제 1: 업스트림 워크플로 직접 요청

@i18n-localization-v2를 사용하여 <작업>을 처리하세요. 복사된 업스트림 워크플로에서 시작하고, 결과를 변경하는 파일만 로드하며, 출처를 답변에 표시하세요.

설명: 운영자가 가져온 워크플로는 필요하지만 전체 리포지토리는 필요하지 않을 때 가장 안전한 시작점입니다.

예제 2: 출처 기반 리뷰 요청

@i18n-localization-v2를 metadata.json 및 ORIGIN.md와 함께 검토하고, 어떤 복사된 업스트림 파일을 먼저 로드할지와 그 이유를 설명하세요.

설명: 정확하고 감사 가능한 출처 및 파일 선택 설명이 필요할 때 리뷰 또는 문제 해결 전에 사용하세요.

예제 3: 실행 전 복사된 지원 파일 범위 좁히기

@i18n-localization-v2를 사용하여 <작업>을 처리하세요. 결과를 변경하는 복사된 참조, 예제 또는 스크립트만 로드하고, 진행 전에 파일 이름을 명시적으로 지정하세요.

설명: 기본적으로 전체 복사 패키지를 로드하는 대신 점진적 공개와 스킬을 일치시킵니다.

예제 4: 리뷰어 패킷 만들기

@i18n-localization-v2를 복사된 업스트림 파일과 출처를 사용하여 검토하고, 병합 전에 누락된 부분을 요약하세요.

설명: PR이 인간 리뷰를 기다리고 있고 반복 가능한 감사 패킷을 원할 때 유용합니다.

모범 사례

생성된 공개 스킬을 업스트림 리포지토리 주변의 검토 가능한 패키징 레이어로 취급하세요. 목표는 출처를 명시적으로 유지하고 실행을 실질적으로 개선하는 복사된 소스 자료만 로드하는 것입니다.

  • 번역 키 사용, 원시 텍스트 사용 금지
  • 기능별로 번역 네임스페이스 지정
  • 복수형 지원
  • 로케일별 날짜/숫자 형식 처리
  • 처음부터 RTL 계획
  • 복잡한 문자열에 ICU 메시지 형식 사용
  • 컴포넌트에 문자열 하드코딩 금지

가져온 운영 노트

가져옴: 5. 모범 사례

해야 할 일 ✅

  • 번역 키 사용, 원시 텍스트 사용 금지
  • 기능별로 번역 네임스페이스 지정
  • 복수형 지원
  • 로케일별 날짜/숫자 형식 처리
  • 처음부터 RTL 계획
  • 복잡한 문자열에 ICU 메시지 형식 사용

하지 말아야 할 일 ❌

  • 컴포넌트에 문자열 하드코딩 금지
  • 번역된 문자열 연결 금지
  • 텍스트 길이 가정 금지 (독일어는 30% 더 길어짐)
  • RTL 레이아웃 잊지 않기
  • 같은 파일에 언어 혼용 금지

문제 해결

문제: 운영자가 가져온 컨텍스트를 건너뛰고 너무 일반적인 답변을 제공함

증상: 결과가 plugins/antigravity-awesome-skills/skills/i18n-localization의 업스트림 워크플로를 무시하고, 출처를 언급하지 않거나, 복사된 소스 파일을 전혀 사용하지 않음. 해결책: metadata.json, ORIGIN.md 및 가장 관련성 높은 복사된 업스트림 파일을 다시 엽니다. 먼저 external_source 블록을 확인한 후 출처를 다시 명시하고 계속 진행합니다.

문제: 리뷰 중 가져온 워크플로가 불완전하게 느껴짐

증상: 리뷰어는 생성된 SKILL.md를 볼 수 있지만, 현재 작업에 어떤 참조, 예제 또는 스크립트가 중요한지 빠르게 파악할 수 없음. 해결책: 선택한 경로를 정당화하는 정확한 복사된 참조, 예제, 스크립트 또는 자산을 지정합니다. 여전히 실제 격차가 있다면 PR에 숨기지 않고 기록합니다.

문제: 작업이 다른 전문 분야로 이동함

증상: 가져온 스킬이 올바른 위치에서 시작했지만, 작업이 디버깅, 아키텍처, 디자인, 보안 또는 릴리스 오케스트레이션으로 전환되어 네이티브 스킬이 더 잘 처리함. 해결책: 관련 스킬 섹션을 사용하여 의도적으로 인계합니다. 가져온 출처를 계속 표시하여 다음 스킬이 빈 상태로 시작하는 대신 올바른 컨텍스트를 상속받도록 합니다.

관련 스킬

  • @00-andruia-consultant - 이 가져온 스킬이 컨텍스트를 설정한 후 작업이 해당 네이티브 전문화로 더 잘 처리될 때 사용
  • @00-andruia-consultant-v2 - 이 가져온 스킬이 컨텍스트를 설정한 후 작업이 해당 네이티브 전문화로 더 잘 처리될 때 사용
  • @10-andruia-skill-smith - 이 가져온 스킬이 컨텍스트를 설정한 후 작업이 해당 네이티브 전문화로 더 잘 처리될 때 사용
  • @10-andruia-skill-smith-v2 - 이 가져온 스킬이 컨텍스트를 설정한 후 작업이 해당 네이티브 전문화로 더 잘 처리될 때 사용

추가 리소스

이 지원 매트릭스와 아래 링크된 파일을 이 가져온 스킬의 운영자 패킷으로 사용하세요. 일반적인 스캐폴딩이 아닌 실제 복사된 소스 자료를 반영해야 합니다.

리소스 패밀리리뷰어에게 제공하는 것예시 경로
references업스트림에서 복사된 참고 노트, 가이드 또는 배경 자료references/n/a
examples업스트림에서 복사된 작업 예제 또는 재사용 가능한 프롬프트examples/n/a
scripts실행 또는 검증을 변경하는 업스트림 헬퍼 스크립트scripts/i18n_checker.py
agents가져온 패키지의 일부인 라우팅 또는 위임 노트agents/n/a
assets소스 패키지에서 복사된 지원 자산 또는 스키마assets/n/a

가져온 참조 노트

가져옴: 3. 구현 패턴

React (react-i18next)

import { useTranslation } from 'react-i18next';

function Welcome() {
  const { t } = useTranslation();
  return <h1>{t('welcome.title')}</h1>;
}

Next.js (next-intl)

import { useTranslations } from 'next-intl';

export default function Page() {
  const t = useTranslations('Home');
  return <h1>{t('title')}</h1>;
}

Python (gettext)

from gettext import gettext as _

print(_("Welcome to our app"))

가져옴: 4. 파일 구조

locales/
├── en/
│   ├── common.json
│   ├── auth.json
│   └── errors.json
├── tr/
│   ├── common.json
│   ├── auth.json
│   └── errors.json
└── ar/          # RTL
    └── ...

가져옴: 6. 일반적인 문제

문제해결책
번역 누락기본 언어로 대체
하드코딩된 문자열린터/검사기 스크립트 사용
날짜 형식Intl.DateTimeFormat 사용
숫자 형식Intl.NumberFormat 사용
복수형ICU 메시지 형식 사용

가져옴: 7. RTL 지원

/* CSS 논리 속성 */
.container {
  margin-inline-start: 1rem;  /* margin-left 아님 */
  padding-inline-end: 1rem;   /* padding-right 아님 */
}

[dir="rtl"] .icon {
  transform: scaleX(-1);
}

가져옴: 8. 체크리스트

배포 전:

  • 모든 사용자 대상 문자열이 번역 키 사용
  • 지원되는 모든 언어에 대한 로케일 파일 존재
  • 날짜/숫자 형식이 Intl API 사용
  • RTL 레이아웃 테스트 완료 (해당하는 경우)
  • 대체 언어 구성됨
  • 컴포넌트에 하드코딩된 문자열 없음

가져옴: 스크립트

스크립트목적명령어
scripts/i18n_checker.py하드코딩된 문자열 및 누락된 번역 감지python scripts/i18n_checker.py <project_path>

가져옴: 제한 사항

  • 이 스킬은 작업이 위에서 설명한 범위와 명확하게 일치할 때만 사용하세요.
  • 출력을 환경별 검증, 테스트 또는 전문가 리뷰를 대체하는 것으로 취급하지 마세요.
  • 필수 입력, 권한, 안전 경계 또는 성공 기준이 누락된 경우 멈추고 명확히 요청하세요.

Individual skills in this repo

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

diegosouzapw/awesome-omni-skills

AgentFolio workflow skill. Use this skill when the user needs Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

AgentFolio workflow skill. Use this skill when the user needs Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

AI UGC Ads workflow skill. Use this skill when the user needs When the user wants to create UGC ad campaigns, recruit UGC creators, generate AI UGC content, or scale with user-generated content. Also use when the user mentions 'UGC,' 'user-generated content,' 'creator ads,' 'Spark Ads,' 'whitelisting,' 'AI UGC,' 'Arcads,' 'Creatify,' 'creator brief,' or 'UGC testing.' This skill covers the UGC growth framework from creator recruitment through AI-powered scaling. Do NOT use for technical implementation, code review, or software architecture and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Astro Web Framework workflow skill. Use this skill when the user needs Build content-focused websites with Astro \u2014 zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Copy Editing workflow skill. Use this skill when the user needs You are an expert copy editor specializing in marketing and conversion copy. Your goal is to systematically improve existing copy through focused editing passes while preserving the core message and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Copy Editing workflow skill. Use this skill when the user needs You are an expert copy editor specializing in marketing and conversion copy. Your goal is to systematically improve existing copy through focused editing passes while preserving the core message and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Copy Editing workflow skill. Use this skill when the user needs You are an expert copy editor specializing in marketing and conversion copy. Your goal is to systematically improve existing copy through focused editing passes while preserving the core message and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Fal Image Edit workflow skill. Use this skill when the user needs AI-powered image editing with style transfer and object removal and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Fal Image Edit workflow skill. Use this skill when the user needs AI-powered image editing with style transfer and object removal and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

frontend-design workflow skill. Use this skill when the user needs Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications. Generates creative, polished code that avoids generic AI aesthetics. Do NOT use for design review or audit (use web-design-guidelines or web-quality-audit) and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Frontend Design (Distinctive, Production-Grade) workflow skill. Use this skill when the user needs You are a frontend designer-engineer, not a layout generator and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

i18n & Localization workflow skill. Use this skill when the user needs Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Interactive Portfolio workflow skill. Use this skill when the user needs Expert in building portfolios that actually land jobs and clients - and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Interactive Portfolio workflow skill. Use this skill when the user needs Expert in building portfolios that actually land jobs and clients - and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Landing Page Generator workflow skill. Use this skill when the user needs Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Landing Page Generator workflow skill. Use this skill when the user needs Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Interactive Portfolio workflow skill. Use this skill when the user needs Expert in building portfolios that actually land jobs and clients - and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Paid Creative AI workflow skill. Use this skill when the user needs When the user wants to create AI-generated ad creative, test performance creative, manage creative fatigue, or optimize paid media with AI tools. Also use when the user mentions 'ad creative,' 'performance creative,' 'creative testing,' 'creative fatigue,' 'Meta ads,' 'Google ads,' 'TikTok ads,' 'AI ads,' 'ad budget,' 'ROAS,' 'Advantage+,' or 'Performance Max.' This skill covers AI-powered paid creative from generation through performance optimization. Do NOT use for technical implementation, code review, or software architecture and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

SEO-AEO Landing Page Writer workflow skill. Use this skill when the user needs Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

SEO-AEO Landing Page Writer workflow skill. Use this skill when the user needs Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

관련 스킬