클로드스킬마트스킬 둘러보기바로 쓰는 문장영상으로 배우기터미널 사용법스킬이 뭐예요?
목록으로

i18next 다국어화 자동 설정

하드코딩된 문자열이 가득한 앱을 i18next + Locize 기반의 다국어 앱으로 단계별 전환해 주는 스킬입니다.

개발·코딩중급23436AI 점수 9/10마지막 업데이트: 2026. 9. 2.

무엇을 해주나

  • i18next-clilocalize --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 번역까지 붙이려는 팀

활용 예시

  1. "내 React 앱에 i18n 붙여줘" → 스택 감지 후 i18next + react-i18next 설치 여부 확인, 설정 파일 생성, dry-run 계획 제시.
  2. "독일어랑 프랑스어 지원하고 싶어" → 키 추출 후 Locize로 동기화하고 AI 번역 결과를 다시 리포지토리로 내려받는 흐름 안내.
  3. "하드코딩된 문자열 찾아서 t()로 감싸줘" → 손으로 고치지 않고 instrument를 실행해 AST 기반으로 일괄 처리.

· · · 설치 가이드 · · ·

설치 없이 지금 한 번 써보기

아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/i18next/i18next-cli/HEAD/skills/i18next-localization/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.

쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
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자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 열고 저장소를 임시 폴더로 복제합니다: git clone https://github.com/i18next/i18next-cli.git /tmp/i18next-cli
  2. 스킬 폴더가 없으면 만듭니다: mkdir -p ~/.claude/skills
  3. 스킬을 복사합니다: cp -r /tmp/i18next-cli/skills/i18next-localization ~/.claude/skills/
  4. references/stacks.md 등 참조 파일이 함께 복사되었는지 확인합니다.
  5. Node.js가 설치되어 있어야 합니다(npx i18next-cli --help로 확인).
  6. Locize를 함께 쓸 경우 https://www.locize.app 에서 프로젝트를 만들고 LOCIZE_PROJECTID, LOCIZE_API_KEY를 환경 변수로 등록합니다. API 키는 절대 클라이언트 코드에 넣지 마세요.
  7. Claude Code를 재시작하고 "내 앱을 다국어화해줘"처럼 요청하면 스킬이 발동합니다. 작업 전 git 커밋으로 깨끗한 상태를 만들어 두세요.