i18n 동등성 관리 (i18n-parity)
UI 키·위키·번역 가이드·언어 선택기·로케일 포맷까지 5개 로컬라이제이션 표면을 한 PR에서 동시에 맞추도록 강제하는 스킬.
개발·코딩고급★ 1,063⑂ 248AI 점수 7/10마지막 업데이트: 2026. 10. 11.
무엇을 해주나
이 스킬은 하나의 저장소가 5개의 독립적인 로컬라이제이션 표면(대시보드 UI JSON 키, 위키 페이지, 전체 미러 가이드 README-XX.md, 언어 선택기, 로케일 인식 포맷팅)을 갖는다는 전제에서, 어느 한 곳만 바꾸고 나머지를 빼먹는 "반쯤 번역된" 상태를 막아줍니다.
- 영어가 모든 표면의 원본(source of truth)이라는 불변 규칙을 명시
- "무엇을 바꿨으면 무엇을 함께 바꿔야 하는지"를 표로 매핑
- 번역하지 말아야 할 대상(코드, 경로, CLI 플래그, 후크 이벤트명, 도구명
Agent등)을 구분 - 의도적으로 번역 대상이 아닌 파일(루트 index.html, CLI, MCP 서버 등)을 명시해 불필요한 작업을 차단
i18n-audit.sh, 클라이언트/서버 테스트, 위키 DOM 테스트로 구성된 검증 명령 체크리스트 제공
이런 분께 추천
- Claude-Code-Agent-Monitor 저장소에 기여하는 개발자
- 다국어 웹앱 + 문서 + 정적 위키를 동시에 운영하며 번역 누락이 반복되는 팀(구조를 자기 레포에 맞게 개조할 의지가 있는 경우)
- 신규 언어 추가 작업을 기계적 체크리스트로 관리하고 싶은 메인테이너
활용 예시
- 대시보드에 새 버튼 문구를 추가 →
en네임스페이스에 키를 넣는 즉시zh/vi/ko/es동일 키 경로·동일 타입·동일{{보간}}토큰까지 함께 추가하도록 유도. README-EN.md의 한 섹션을 수정 →README-CN/VN/KO/ES.md의 동일 섹션을 같은 PR에서 미러링하고 제목 수 차이를 감사 스크립트로 확인.- 새 언어(예:
ja) 추가 →references/new-language-checklist.md를 의존성 순서대로 따라가며 위키 본문 번들,T/META/ATTRIBUTE_TRANSLATIONS, 언어 선택기,format.ts로케일 맵까지 전부 채움.
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/hoangsonww/Claude-Code-Agent-Monitor/HEAD/.agents/skills/i18n-parity/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 hoangsonww/Claude-Code-Agent-Monitor 의 .agents/skills/i18n-parity 폴더를 내 ~/.claude/skills/i18n-parity/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/hoangsonww/Claude-Code-Agent-Monitor.git /tmp/ccam && mkdir -p ~/.claude/skills && cp -r /tmp/ccam/.agents/skills/i18n-parity ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 엽니다.
- 저장소를 클론합니다:
git clone https://github.com/hoangsonww/Claude-Code-Agent-Monitor.git - 스킬 폴더를 만듭니다:
mkdir -p ~/.claude/skills - 스킬을 복사합니다:
cp -r Claude-Code-Agent-Monitor/.agents/skills/i18n-parity ~/.claude/skills/ - 이 스킬이 참조하는
scripts/i18n-audit.sh와references/*.md는 원본 위치(.claude/skills/i18n-parity/)에 있으므로, 해당 폴더도 함께 복사하거나 저장소 내부에서 Claude Code를 실행하세요. - 다른 프로젝트에서 쓰려면
SKILL.md안의 파일 경로·테스트 명령·지원 언어 목록을 본인 프로젝트 구조에 맞게 수정합니다. - Claude Code를 재시작하고 "i18n 키를 추가했어"처럼 말해 스킬이 발동하는지 확인합니다.
GitHub에서 원본 보기 ↗라이선스: MIT