Provides utilities to detect hardcoded text and sync translation keys for i18next-based projects.
Install
mkdir -p .claude/skills/i18n-project-n-e-k-o && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/17526" && unzip -o skill.zip -d .claude/skills/i18n-project-n-e-k-o && rm skill.zipInstalls to .claude/skills/i18n-project-n-e-k-o
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
i18n (internationalization) toolkit for projects using i18next. Provides three main functions: (1) i18n-check - Detect hardcoded Chinese text in HTML/JS files, (2) i18n-fix - Replace hardcoded text with i18n markers, (3) i18n-sync - Align translation keys across multiple languages (zh-CN, zh-TW, en, ja, ko, ru, es, pt). Use when working on internationalization tasks, detecting untranslated strings, or syncing locale files.Key capabilities
- →Detect hardcoded Chinese text in HTML/JS files
- →Replace hardcoded text with i18n markers
- →Align translation keys across multiple languages
- →Check frontend files for i18n issues
- →Fix HTML by adding `data-i18n` attributes
- →Fix JS by wrapping strings in `window.t()`
How it works
This skill provides a toolkit for i18n using i18next, offering functions to check for hardcoded Chinese text, fix it by inserting i18n markers, and synchronize translation keys across multiple locale files.
Inputs & outputs
When to use i18n
- →Find hardcoded strings
- →Inject i18n keys
- →Sync language files
- →Check translation coverage
About this skill
i18n Toolkit
Complete i18n (internationalization) toolkit for projects using i18next.
Architecture
- i18n library: i18next
- Locale files:
static/locales/(zh-CN, zh-TW, en, ja, ko, ru, es, pt) - HTML attributes:
data-i18n,data-i18n-placeholder,data-i18n-title,data-i18n-alt - JS function:
window.t()ori18next.t() - Progress file:
.claude/i18n-progress.json
Three Main Commands
1. i18n-check - Detect Issues
Check frontend files for hardcoded Chinese text.
/i18n-check <module> [options]
Modules: main, live2d, voice, steam, settings, chat, custom
Options: --status, --reset, --files=<path>, --html, --js, --strict
See references/check-modules.md for module file mappings.
2. i18n-fix - Fix Issues
Replace hardcoded Chinese with i18n markers.
/i18n-fix <module> [--add-keys]
Fix patterns:
- HTML: Add
data-i18n="key"attributes - JS: Use
window.t('key')with fallback
See references/fix-patterns.md for examples.
3. i18n-sync - Sync Languages
Align translation keys across all languages.
uv run python scripts/i18n_sync.py # Check status
uv run python scripts/i18n_sync.py --apply # Apply changes
Quick Workflow
- Check:
/i18n-check steam- Find hardcoded strings - Fix:
/i18n-fix steam- Replace with i18n markers - Verify:
/i18n-check steam- Confirm fixes - Sync:
/i18n-sync- Sync to other languages
Detection Rules
Check for:
- HTML: Chinese text in elements or attributes
- JS: Chinese strings not wrapped in
window.t()
Skip:
- Already has
data-i18n*orwindow.t()wrapper console.log/error/warndebug messages- Third-party libs (
static/libs/) - Comments
- Internal logic strings (e.g.,
includes('已离开')) - Data keys (e.g.,
data['档案名'])
When not to use it
- →When the project does not use i18next for internationalization
- →When dealing with languages other than the specified locales (zh-CN, zh-TW, en, ja, ko, ru, es, pt)
Limitations
- →Specific to projects using i18next
- →Detection rules are focused on Chinese text and specific HTML/JS patterns
- →Locale files are expected in `static/locales/`
How it compares
This skill automates the detection and remediation of hardcoded strings and ensures consistency across multiple translation files, which is more efficient than manual internationalization efforts.
Compared to similar skills
i18n side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| i18n (this skill) | 0 | 1mo | Review | Intermediate |
| browser-extension-developer | 4 | 6mo | No flags | Intermediate |
| add-i18n-locale | 0 | 1mo | No flags | Beginner |
| vue-i18n-skilld | 0 | 3mo | No flags | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by Project-N-E-K-O
View all by Project-N-E-K-O →You might also like
browser-extension-developer
yamadashy
Use this skill when developing or maintaining browser extension code in the `browser/` directory, including Chrome/Firefox/Edge compatibility, content scripts, background scripts, or i18n updates.
add-i18n-locale
GXFG
NaiveTab 浏览器扩展的 i18n 国际化开发指南。当用户要新增/修改翻译文本、添加多语言 key 时使用。涵盖中英文同步更新规则、变量替换模式等，防止遗漏或格式错误。
vue-i18n-skilld
skilld-dev
Internationalization plugin for Vue.js. ALWAYS use when writing code importing \"vue-i18n\". Consult for debugging, best practices, or modifying vue-i18n, vue i18n.
harden
Aixbox
Improve interface resilience through better error handling, i18n support, text overflow handling, and edge case management. Makes interfaces robust and production-ready. Use when the user asks to harden, make production-ready, handle edge cases, add error states, or fix overflow and i18n issues.
zustand
lobehub
Zustand state management guide. Use when working with store code (src/store/**), implementing actions, managing state, or creating slices. Triggers on Zustand store development, state management questions, or action implementation.
threejs-skills
sickn33
Three.js skills for creating 3D elements and interactive experiences