junnv93/verify-i18n
.claude/skills/verify-i18n/SKILL.md
Verifies i18n translation consistency — en/ko key pair matching, no empty translations, namespace references, Zod schema hardcoded message detection, dynamic i18n key coverage, routeMap↔navigation.json sync. Run after adding/modifying messages/{en,ko}/*.json or route-metadata.ts.
development
Updated Apr 16, 2026
$ install --global
skillsauthnpx skillsauth add junnv93/equipment_management_system verify-i18nInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 16, 2026, 12:58 PM6.1s2 files scanned
SKILL.md
- name:
- verify-i18n
- description:
- Verifies i18n translation consistency — en/ko key pair matching, no empty translations, namespace references, Zod schema hardcoded message detection, dynamic i18n key coverage, routeMap↔navigation.json sync. Run after adding/modifying messages/{en,ko}/*.json or route-metadata.ts.
- disable-model-invocation:
- true
- argument-hint:
- [선택사항: 특정 도메인명 (equipment, dashboard, audit 등)]
i18n 번역 일관성 검증
Purpose
apps/frontend/messages/ 디렉토리의 번역 파일이 다음 규칙을 준수하는지 검증합니다:
- en/ko 키 쌍 일치 — 모든 번역 도메인에서 영어/한국어 파일이 동일한 키 구조를 가져야 함
- 빈 번역 없음 — 빈 문자열("")로 남겨진 번역 없음
- 네임스페이스 참조 일관성 —
useTranslations('namespace')호출과 실제 메시지 파일이 일치 - 누락된 도메인 파일 — en/에 있는 파일이 ko/에도 존재하고 그 반대도 성립
When to Run
apps/frontend/messages/{en,ko}/*.json을 추가/수정한 후- 새 컴포넌트에서
useTranslations()또는getTranslations()를 사용한 후 - 번역 키를 추가하거나 삭제한 후
lib/navigation/route-metadata.ts에 라우트를 추가/수정한 후
Related Files
| File | Purpose |
|---|---|
| apps/frontend/messages/en/*.json | 영어 번역 파일 (도메인별) |
| apps/frontend/messages/ko/*.json | 한국어 번역 파일 (도메인별) |
| apps/frontend/lib/i18n/request.ts | next-intl 설정 |
| apps/frontend/lib/i18n/use-enum-labels.ts | i18n 기반 Enum Label Hooks |
| apps/frontend/lib/navigation/route-metadata.ts | routeMap — 브레드크럼 labelKey SSOT |
| apps/frontend/lib/navigation/use-breadcrumb-metadata.ts | 동적 브레드크럼 라벨 훅 |
Workflow
Step 1: en/ko 파일 쌍 존재 확인
두 언어 디렉토리에 동일한 파일이 모두 존재하는지 확인합니다. PASS: 두 디렉토리의 파일 목록이 완전 일치. FAIL: 한쪽에만 파일이 있으면 누락.
상세: references/i18n-checks.md Step 1
Step 2: 도메인별 en/ko 키 쌍 일치 확인
각 도메인 파일의 JSON 키 구조가 en/ko 간에 완전히 일치하는지 확인합니다. PASS: 모든 도메인에서 키 불일치 없음. FAIL: 키 불일치 발견 시 누락 쪽에 추가.
상세: references/i18n-checks.md Step 2
Step 3: 빈 번역 값 탐지
비어 있는 번역 문자열("")을 탐지합니다. PASS: 0개 결과. FAIL: 빈 문자열 발견 시 실제 번역 추가.
상세: references/i18n-checks.md Step 3
Step 4: useTranslations 네임스페이스 참조 확인
컴포넌트에서 사용하는 번역 네임스페이스가 실제 메시지 파일과 일치하는지 확인합니다. PASS: 모든 최상위 네임스페이스에 대응 파일 존재. FAIL: 미존재 네임스페이스 참조.
상세: references/i18n-checks.md Step 4
Step 5: ICU 메시지 변수 쌍 일치 확인
en/ko에서 {variable} 플레이스홀더가 동일하게 사용되는지 확인합니다.
PASS: 차이 없음. INFO: 불일치 시 수동 확인 권장.
상세: references/i18n-checks.md Step 5
Step 6: 프론트엔드 Zod 스키마 하드코딩 메시지 탐지
컴포넌트 내 Zod 스키마에서 하드코딩된 검증 메시지를 탐지합니다.
PASS: 0개 결과. FAIL: 하드코딩 발견 시 createSchema(t) 팩토리 패턴으로 전환.
상세: references/i18n-checks.md Step 6
Step 7: 동적 i18n 키 커버리지 확인
t('key.${dynamicValue}') 패턴의 동적 키가 en/ko JSON에 모두 존재하는지 확인합니다.
PASS: 모든 enum 값에 대응 키 존재. FAIL: 누락 시 런타임 raw 키 표시.
상세: references/i18n-checks.md Step 7
Step 8: routeMap labelKey ↔ navigation.json 교차 검증
route-metadata.ts의 모든 labelKey가 navigation.json에 실제로 존재하는지 확인합니다.
또한, 실제 존재하는 app/(dashboard)/**/page.tsx에 대응하는 routeMap 항목이 있는지 역방향 검증합니다.
PASS: 모든 labelKey가 navigation.json에 존재하고, 모든 페이지가 routeMap에 등록됨. FAIL: 누락 발견.
상세: references/i18n-checks.md Step 8
Output Format
| # | 검사 | 상태 | 상세 |
| --- | ------------------------------- | --------- | ------------------------ |
| 1 | en/ko 파일 쌍 존재 | PASS/FAIL | 누락 파일 목록 |
| 2 | 도메인별 키 쌍 일치 | PASS/FAIL | 불일치 도메인 + 키 목록 |
| 3 | 빈 번역 값 | PASS/FAIL | 빈 값 위치 목록 |
| 4 | 네임스페이스 참조 일관성 | PASS/INFO | 미존재 네임스페이스 목록 |
| 5 | ICU 변수 쌍 일치 | PASS/INFO | 변수 불일치 도메인 목록 |
| 6 | Zod 스키마 하드코딩 메시지 | PASS/FAIL | 하드코딩 파일:라인 목록 |
| 7 | 동적 i18n 키 커버리지 | PASS/FAIL | 누락된 동적 키 목록 |
| 8 | routeMap↔navigation.json 동기화 | PASS/FAIL | 누락 키/미등록 라우트 |
Exceptions
다음은 위반이 아닙니다:
reservations.json— 예약 기능이 미구현이므로 일부 키가 플레이스홀더로 남아있을 수 있음- 중첩 네임스페이스
useTranslations('common.actions')—common.json파일이 존재하면 파일 누락이 아님 - Step 4의 동적 네임스페이스 —
useTranslations(dynamicNs)같은 동적 참조는 탐지 불가, 수동 확인 필요 - ICU 복수형(plural) 문법 — 언어마다 다를 수 있으므로 Step 5에서 INFO로 보고
- Step 5의 INFO 등급 — ICU 변수 불일치는 자동 수정 불가한 경우가 있으므로 FAIL이 아닌 INFO
Related Skills
junnv93/verify-zod
testing
VerifiedTrustedCommunity
Verifies Zod validation pattern compliance — ZodValidationPipe usage (no class-validator), versionedSchema inclusion in state-change DTOs, controller pipe application, query DTO consistency. Run after adding/modifying DTOs or controller endpoints.
SKILL.mdUpdated Apr 16, 2026
junnv93/verify-workflows
testing
VerifiedTrustedCommunity
Verifies cross-feature workflow E2E test coverage against critical-workflows.md checklist. Checks WF-01~WF-35 coverage, step completeness, role correctness, side-effect verification, and status transition assertions. Run after adding workflow tests or before PR.
SKILL.mdUpdated Apr 16, 2026
junnv93/verify-ssot
testing
VerifiedTrustedCommunity
SSOT(Single Source of Truth) 임포트 소스를 검증합니다. 타입/enum/상수가 올바른 패키지에서 임포트되는지 확인. 타입/enum 추가/수정 후 사용.
SKILL.mdUpdated Apr 16, 2026
junnv93/verify-sql-safety
development
VerifiedTrustedCommunity
Verifies SQL safety — LIKE wildcard escaping, N+1 query pattern detection, COUNT(DISTINCT) for fan-out JOINs, RBAC INNER JOIN enforcement. Run after adding/modifying search or list API endpoints.
SKILL.mdUpdated Apr 16, 2026