Communitygithub.com

JantonioFC/skillsbank

국제화 및 지역화 패턴. 하드코딩된 문자열 탐지, 번역 관리, 로케일 파일, RTL 지원.

skillsbank란 무엇인가요?

이 스킬은 애플리케이션의 국제화(i18n)와 지역화(L10n)를 구현하기 위한 종합 가이드를 제공합니다. 웹 애플리케이션, SaaS 제품 등 다양한 프로젝트 유형에서 i18n이 필요한지 판단하는 기준을 제시하며, React, Next.js, Python 환경에서의 구체적인 구현 패턴을 예제 코드와 함께 설명합니다. 또한, 로케일 파일 구조, 번역 키 사용, 복수형 처리, 날짜/숫자 형식, RTL(오른쪽에서 왼쪽) 언어 지원 등 모범 사례를 상세히 다루고, 하드코딩된 문자열 탐지 및 누락된 번역을 확인할 수 있는 스크립트를 포함하고 있습니다. 이 스킬은 Claude Code, Cursor, Codex와 같은 AI 에이전트 플랫폼에서 활용될 수 있으며, 개발자가 i18n 작업을 보다 체계적이고 효율적으로 수행할 수 있도록 돕습니다. 지원하는 플랫폼에 대한 구체적인 언급은 없지만, 범용적인 기술 스택에 적용 가능합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JantonioFC/skillsbank/tree/HEAD/plugins/antigravity-awesome-skills-claude/skills/i18n-localization

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

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

문서

i18n 및 지역화

국제화(i18n) 및 지역화(L10n) 모범 사례.


1. 핵심 개념

용어의미
i18n국제화 - 앱을 번역 가능하게 만드는 과정
L10n지역화 - 실제 번역 작업
Locale언어 + 지역 (en-US, tr-TR)
RTL오른쪽에서 왼쪽으로 쓰는 언어 (아랍어, 히브리어)

2. i18n 적용 시점

프로젝트 유형i18n 필요 여부
공개 웹 앱✅ 필요
SaaS 제품✅ 필요
내부 도구⚠️ 상황에 따라
단일 지역 앱⚠️ 향후 확장 고려
개인 프로젝트❌ 선택 사항

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
    └── ...

5. 모범 사례

권장 사항 ✅

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

주의 사항 ❌

  • 컴포넌트에 문자열 하드코딩 금지
  • 번역된 문자열 연결 금지
  • 텍스트 길이를 고정하지 말 것 (독일어는 30% 더 김)
  • 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.

JantonioFC/skillsbank

AI-powered image editing with style transfer and object removal

JantonioFC/skillsbank

Analise e auditoria de editais de leilao judicial e extrajudicial. Riscos ocultos, clausulas perigosas, debitos, ocupante e classificacao da oportunidade.

JantonioFC/skillsbank

Embed Photopea in web apps using photopea.js. Covers embedding, file I/O, scripting, exporting, layers, text, filters, and the full Photoshop-compatible API.

JantonioFC/skillsbank

Best practices for Remotion - Video creation in React

JantonioFC/skillsbank

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

JantonioFC/skillsbank

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

JantonioFC/skillsbank

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.

JantonioFC/skillsbank

Video and audio perception, indexing, and editing. Ingest files/URLs/live streams, build visual/spoken indexes, search with timestamps, edit timelines, add overlays/subtitles, generate media, and create real-time alerts.

JantonioFC/skillsbank

Upload, stream, search, edit, transcribe, and generate AI video and audio using the VideoDB SDK.

JantonioFC/skillsbank

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

JantonioFC/skillsbank

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

JantonioFC/skillsbank

Tool lifecycle UI components for React/Next.js from ui.inference.sh. Display tool calls: pending, progress, approval required, results. Capabilities: tool status, progress indicators, approval flows, results display. Use for: showing agent tool calls, human-in-the-loop approvals, tool output. Triggers: tool ui, tool calls, tool status, tool approval, tool results, agent tools, mcp tools ui, function calling ui, tool lifecycle, tool pending

JantonioFC/skillsbank

Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

JantonioFC/skillsbank

When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms. Also use when the user mentions 'PPC,' 'paid media,' 'ROAS,' 'CPA,' 'ad campaign,' 'retargeting,' 'audience targeting,' 'Google Ads,' 'Facebook ads,'...

JantonioFC/skillsbank

Create AI avatar and talking head videos with OmniHuman, Fabric, PixVerse via inference.sh CLI. Models: OmniHuman 1.5, OmniHuman 1.0, Fabric 1.0, PixVerse Lipsync. Capabilities: audio-driven avatars, lipsync videos, talking head generation, virtual presenters. Use for: AI presenters, expla...

JantonioFC/skillsbank

Create AI marketing videos for ads, promos, product launches, and brand content. Models: Veo, Seedance, Wan, FLUX for visuals, Kokoro for voiceover. Types: product demos, testimonials, explainers, social ads, brand videos. Use for: Facebook ads, YouTube ads, product launches, brand awarene...

JantonioFC/skillsbank

Generate AI videos with Google Veo, Seedance, Wan, Grok and 40+ models via inference.sh CLI. Models: Veo 3.1, Veo 3, Seedance 1.5 Pro, Wan 2.5, Grok Imagine Video, OmniHuman, Fabric, HunyuanVideo. Capabilities: text-to-video, image-to-video, lipsync, avatar animation, video upscaling, fole...

JantonioFC/skillsbank

Production-ready CI/CD configurations for Playwright — GitHub Actions, GitLab CI, CircleCI, Azure DevOps, Jenkins, Docker, parallel sharding, reporting, code coverage, and global setup/teardown.

JantonioFC/skillsbank

Next.js 16+ and Turbopack — incremental bundling, FS caching, dev speed, and when to use Turbopack vs webpack.

JantonioFC/skillsbank

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.

관련 스킬