akiver/cs-demo-manager/i18n
- community
Checking that the SKILL.md file is still in the repository.
Add or update translated strings in the CS Demo Manager UI using LinguiJS. Use when adding user-visible text, labels, placeholders, error messages, or any string that should be localized. Handles Trans, useLingui, Plural, msg macros, context disambiguation, and the extract workflow.
Install
npx vskill@latest install akiver/cs-demo-manager/i18nSKILL.md
Scope
Only src/ui/ and src/electron-main/ need translations. Server, node, and CLI code is exempt.
Patterns
Always Use Macros
Prefer macros over runtime components. Macros are compiled at build time, reducing bundle size:
It's enforced by a lint rule!
Keep Messages Simple
Avoid complex expressions in messages - they'll be replaced with placeholders:
Use Trans for JSX Content
The Trans macro is the primary way to translate JSX:
When to use: For any translatable text in JSX elements.
Use useLingui for Non-JSX
For strings outside JSX (attributes, alerts, function calls):
When to use: Element attributes, alerts, function parameters, any non-JSX string.
Use msg for Lazy Translations
When you need to define messages in arrays/objects:
When to use: Module-level constants, arrays of messages, conditional message selection.
Pluralization
Use the Plural macro for quantity-dependent messages:
The # placeholder is replaced with the actual value.
Exact Matches
Use _N syntax for exact number matches (takes precedence over plural forms):
With Variables and Components
Combine with Trans for complex messages:
Formatting Dates and Numbers
Use the native Intl API directly with the current locale.
For date formatting, prefer the useFormatDate hook:
For number formatting, use Intl.NumberFormat with the current locale:
Message IDs and Context
Explicit IDs
Only use explicit `id` in `src/electron-main/` — never in the renderer process.
The electron-main process requires explicit IDs because it uses a separate JSON catalog and cannot rely on auto-generated IDs from JSX extraction:
Context for Disambiguation
When the same text has different meanings, use context:
These create separate catalog entries.
Comments for Translators
Add context for translators:
Electron Main Process
src/electron-main/ has its own Lingui config (src/electron-main/lingui.config.ts) and uses JSON catalogs instead of .po. The same macro rules apply; use i18n from @lingui/core directly (no React provider).
After adding or changing strings
Re-generate the catalogs (both UI and electron-main):
Only the English source catalogs (src/ui/translations/en/messages.po and src/electron-main/translations/en/messages.json) are committed — commit those. The other locales are gitignored, managed on Crowdin, and downloaded at build time, so leave them untracked and never translate them by hand.
Security
- Security scanPassed, 95 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/i18n/SKILL.md
Popularity
- Repository stars
- 1,971
- Repository forks
- 248
- 7-day trend score
- 38
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/akiver/cs-demo-manager/i18n)