# Commandkit I18N

> Implement localization with @commandkit/i18n and i18next. Use for locale resources, command metadata translations, and locale-aware runtime helpers.

- Skill: `neplexlabs/commandkit-i18n` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx skillmds@latest add neplexlabs/commandkit-i18n`
- Raw SKILL.md: https://api.skillmd.com/api/skills/neplexlabs/commandkit-i18n/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: neplexlabs (https://skillmd.com/u/neplexlabs)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/neplexlabs/commandkit-i18n

---


# CommandKit i18n Plugin

## Activation guidance

Use for multilingual command metadata and translated runtime
responses.

## Required filesystem expectations

- plugin registration in `commandkit.config.ts`
- locale files under `src/app/locales/<locale>/*.json`
- command/event handlers in `src/app/commands/**` and
  `src/app/events/**`

## Execution workflow

1. Register `i18n()` plugin.
2. Build locale directory and translation files.
3. Add `$command` keys for metadata localization.
4. Use `ctx.locale()` in commands and `locale()` in events/utilities.
5. Validate missing-key and fallback behavior.

## Guardrails

- Keep translation keys stable across locales.
- Ensure all required keys exist in baseline locale.

## Reference index

| Name                                             | Description                                               |
| ------------------------------------------------ | --------------------------------------------------------- |
| `references/00-filesystem-structure.md`          | Locale folder layout and naming expectations.             |
| `references/01-plugin-setup.md`                  | Plugin setup baseline.                                    |
| `references/02-locales-structure.md`             | Locale file placement and organization details.           |
| `references/03-command-metadata-localization.md` | `$command` and context menu metadata localization format. |
| `references/04-locale-helpers.md`                | Runtime locale helper usage in commands/events.           |

## Tool index

| Name                             | Description                                                          |
| -------------------------------- | -------------------------------------------------------------------- |
| `tools/generate-locale-file.mjs` | Prints a locale JSON starter template for a command and locale code. |