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 a strong skill description that clearly defines its niche in internationalization/localization for UI codebases. It excels at listing specific concrete actions, includes natural trigger terms users would use, and explicitly states both what the skill does and when to use it. The technology stack specificity (React/TS, i18next) further reduces conflict risk with other skills.

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'. Good coverage of both full terms and abbreviations.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive niche focused on i18n/l10n in UI codebases with specific technology stack (React/TS, i18next, JSON locales). Unlikely to conflict with general coding, translation, or other skills due to the precise domain scoping.

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 competent i18n skill with a strong workflow structure and clear validation feedback loops. Its main weaknesses are the lack of executable code examples for key setup steps (config files, provider wiring, language switcher) and some verbosity in sections that describe general i18n concepts Claude already understands. The referenced audit script is not provided in the bundle, reducing actionability.

Suggestions

Add a concrete, executable code example for the i18n config/provider setup (e.g., a complete react-i18next initialization snippet) to improve actionability.

Include the referenced `scripts/i18n_audit.py` in the bundle or provide its implementation inline, since the workflow depends on it.

Trim or remove 'Core Capabilities' and 'Architecture Guidance' sections that describe general i18n knowledge Claude already possesses, keeping only project-specific conventions.

Move 'Failure Modes', 'Performance Notes', and 'Architecture Guidance' into a separate reference file to keep the main SKILL.md focused on the workflow.

DimensionReasoningScore

Conciseness

The skill is reasonably efficient but includes some sections that over-explain or list things Claude already knows (e.g., 'Core Capabilities' listing generic concepts, 'Architecture Guidance' covering basic i18n patterns). Some sections like 'Failure Modes' and 'Performance Notes' add marginal value. The 'Scope Inputs' section is useful but could be tighter.

2 / 3

Actionability

The skill provides some concrete commands (ripgrep patterns, json validation, audit script invocation) and specific patterns like `t('namespace.key')` and `_one/_other` plural keys. However, it lacks executable code examples for the setup steps (no actual i18n config file example, no provider wiring code, no language switcher implementation). The audit script is referenced but not provided in the bundle.

2 / 3

Workflow Clarity

The 8-step workflow is clearly sequenced with an explicit audit-fix-validate feedback loop. Step 8 explicitly requires re-running the audit until issues reach zero, and step 3 treats parity gaps as blockers. The validation checklist at the end provides a final checkpoint. This is a well-structured workflow with appropriate validation gates.

3 / 3

Progressive Disclosure

The skill references `scripts/i18n_audit.py` but no bundle file is provided, making the reference unverifiable. The content is mostly inline in a single file, and while sections are well-organized with headers, some content (Architecture Guidance, Performance Notes, Failure Modes) could be split into separate reference files to keep the main skill leaner. The structure is decent but not optimally layered.

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.