i18next 다국어화 자동 설정
하드코딩된 문자열이 가득한 앱을 i18next + Locize 기반의 다국어 앱으로 단계별 전환해 주는 스킬입니다.
개발·코딩중급★ 234⑂ 36AI 점수 9/10마지막 업데이트: 2026. 9. 2.
무엇을 해주나
i18next-cli의localize --print-agent-prompt로 설치된 CLI 버전에 맞는 최신 작업 절차를 받아와 그대로 수행합니다.- 스택 감지 →
init(설정 파일 생성) →instrument(AST 기반으로 하드코딩 문자열을t()로 감싸기) →extract(로케일 JSON 생성) →locize-sync/locize-download(번역 백엔드 연동 및 AI 번역) 순서를 안내합니다. instrument --dry-run으로 변경 계획을 먼저 보여주고, 적용 후 git diff 검토를 권합니다(Next.js 서버 컴포넌트의'use client'이슈 등).- Vue는
i18next-cli-vue, Svelte는i18next-cli-plugin-svelte플러그인을 사용하도록 스택별 분기를 제공합니다. - 다른 i18n 라이브러리(next-intl, react-intl, vue-i18n, Paraglide 등)가 이미 있거나 작업 트리가 더러우면 작업을 멈추고 사용자에게 확인합니다.
이런 분께 추천
- React/Next.js/Vue/Svelte 앱을 처음 다국어화해야 하는 프론트엔드 개발자
- 이미 i18next를 쓰지만 아직 하드코딩 문자열이 남아 있는 프로젝트 담당자
- 번역 파일을 Locize 같은 관리형 백엔드로 옮기고 AI 번역까지 붙이려는 팀
활용 예시
- "내 React 앱에 i18n 붙여줘" → 스택 감지 후
i18next+react-i18next설치 여부 확인, 설정 파일 생성, dry-run 계획 제시. - "독일어랑 프랑스어 지원하고 싶어" → 키 추출 후 Locize로 동기화하고 AI 번역 결과를 다시 리포지토리로 내려받는 흐름 안내.
- "하드코딩된 문자열 찾아서 t()로 감싸줘" → 손으로 고치지 않고
instrument를 실행해 AST 기반으로 일괄 처리.
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/i18next/i18next-cli/HEAD/skills/i18next-localization/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 i18next/i18next-cli 의 skills/i18next-localization 폴더를 내 ~/.claude/skills/i18next-localization/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/i18next/i18next-cli.git /tmp/i18next-cli && mkdir -p ~/.claude/skills && cp -r /tmp/i18next-cli/skills/i18next-localization ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 열고 저장소를 임시 폴더로 복제합니다:
git clone https://github.com/i18next/i18next-cli.git /tmp/i18next-cli - 스킬 폴더가 없으면 만듭니다:
mkdir -p ~/.claude/skills - 스킬을 복사합니다:
cp -r /tmp/i18next-cli/skills/i18next-localization ~/.claude/skills/ references/stacks.md등 참조 파일이 함께 복사되었는지 확인합니다.- Node.js가 설치되어 있어야 합니다(
npx i18next-cli --help로 확인). - Locize를 함께 쓸 경우 https://www.locize.app 에서 프로젝트를 만들고
LOCIZE_PROJECTID,LOCIZE_API_KEY를 환경 변수로 등록합니다. API 키는 절대 클라이언트 코드에 넣지 마세요. - Claude Code를 재시작하고 "내 앱을 다국어화해줘"처럼 요청하면 스킬이 발동합니다. 작업 전 git 커밋으로 깨끗한 상태를 만들어 두세요.
GitHub에서 원본 보기 ↗라이선스: MIT