CtrlK
BlogDocsLog inGet started
Tessl Logo

i18n-expert

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

1.00x
Quality

81%

Does it follow best practices?

Impact

98%

1.00x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

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.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
daymade/claude-code-skills
Reviewed

Table of Contents

Is this your skill?

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.