This skill should be used when setting up, auditing, or enforcing internationalization/localization in UI codebases (React/TS, i18next or similar, JSON locales), including installing/configuring the i18n framework, replacing hard-coded strings, ensuring en-US/zh-CN coverage, mapping error codes to localized messages, and validating key parity, pluralization, and formatting.
87
81%
Does it follow best practices?
Impact
98%
1.00xAverage score across 3 eval scenarios
Passed
No known issues
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an excellent skill description that clearly defines its scope, lists concrete actions, and provides explicit trigger conditions. It uses third-person voice appropriately and includes a rich set of natural trigger terms spanning both technical specifics (i18next, JSON locales, React/TS) and broader concepts (internationalization, localization). The description is comprehensive yet focused, making it easy for Claude to select this skill precisely when needed.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: installing/configuring i18n framework, replacing hard-coded strings, ensuring en-US/zh-CN coverage, mapping error codes to localized messages, validating key parity, pluralization, and formatting. | 3 / 3 |
Completeness | Clearly answers both 'what' (installing/configuring i18n, replacing hard-coded strings, ensuring locale coverage, mapping error codes, validating key parity) and 'when' ('when setting up, auditing, or enforcing internationalization/localization in UI codebases') with explicit trigger guidance. | 3 / 3 |
Trigger Term Quality | Includes strong natural keywords users would say: 'internationalization', 'localization', 'i18n', 'i18next', 'hard-coded strings', 'JSON locales', 'React/TS', 'en-US', 'zh-CN', 'pluralization', 'error codes'. Good coverage of both abbreviations and full terms. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive niche focused specifically on i18n/localization in React/TS codebases with i18next. The combination of specific technologies, locale pairs, and i18n-specific tasks makes it very unlikely to conflict with other skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
62%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured skill with a strong workflow that follows a clear audit-fix-validate pattern with explicit validation checkpoints. Its main weaknesses are the lack of executable code examples for core setup tasks (config files, provider wiring, locale file structure) and some verbosity in sections that could be condensed or split into referenced files. The skill would benefit from concrete, copy-paste-ready code snippets for the most common framework setup (React + react-i18next).
Suggestions
Add executable code examples for the most critical steps: an example i18n config file, provider wiring snippet, and sample locale JSON structure with plural/placeholder patterns.
Move 'Architecture Guidance', 'Failure Modes', and 'Performance Notes' into a referenced ADVANCED.md or REFERENCE.md to reduce the main file's token footprint.
Trim or remove bullets that explain concepts Claude already knows (e.g., what RTL is, what lazy-loading does) and instead just state the directive concisely.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably efficient but includes some sections that could be tightened—'Core Capabilities' and 'Architecture Guidance' overlap with workflow steps, and some bullet points state things Claude already knows (e.g., explaining what RTL is, what lazy-loading does). The 'Failure Modes' and 'Performance Notes' sections add marginal value for their token cost. | 2 / 3 |
Actionability | The skill provides some concrete commands (rg patterns, json.tool validation, audit script invocation) but lacks executable code examples for the core setup steps (no actual i18n config file, no provider wiring code, no example locale JSON structure). Key steps like 'Wire the provider at the app root' and 'Add a language switcher' are described rather than demonstrated with copy-paste-ready code. | 2 / 3 |
Workflow Clarity | The workflow is clearly sequenced with numbered steps following an Audit -> Fix -> Validate pattern. It includes explicit validation checkpoints (step 3 audit, step 8 re-run audit until zero issues, JSON validation), treats parity gaps as blockers, and has a clear feedback loop (re-run audit until clean). The checklist at the end reinforces verification. | 3 / 3 |
Progressive Disclosure | The skill references an external script (scripts/i18n_audit.py) which is good, but the main file itself is quite long with multiple sections that could be split out (Architecture Guidance, Failure Modes, Validation Checklist). There are no references to separate detailed docs for advanced topics like RTL support, SEO localization, or framework-specific setup guides. | 2 / 3 |
Total | 9 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
4f0eae8
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.