localization-toolkit

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.

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

The canonical home for this skill is i18n-expert in daymade/claude-code-skills

Quality

Content

81%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, actionable i18n skill body with a clear validated workflow and a real, correctly-referenced audit script. Slight redundancy across capability/architecture sections and a few high-level setup steps keep it just short of maximum conciseness and actionability.

Suggestions

Collapse the 'Core Capabilities' list into the Workflow/Architecture sections to remove redundancy and tighten conciseness.

Make setup steps more executable by adding a minimal i18n provider/config code snippet or a concrete file path convention instead of 'Wire the provider at the app root'.

Consolidate 'Performance Notes', 'Failure Modes', and 'Architecture Guidance' into a single concise reference section to improve organization.

Dimension	Reasoning	Score
Conciseness	Mostly lean with no padding about what i18n is, but the 'Core Capabilities' list overlaps with the Workflow and Architecture Guidance sections, leaving a few redundant lines that could be trimmed.	4 / 5
Actionability	Provides executable commands (`python scripts/i18n_audit.py ...`, `rg -n --glob ...`, `python -m json.tool`) and concrete library picks (react-i18next, next-intl, vue-i18n), but several setup steps like 'Wire the provider at the app root' and 'Add a language switcher' remain high-level.	4 / 5
Workflow Clarity	Clear 8-step Audit->Fix->Validate sequence with an explicit feedback loop in step 8 ('Re-run the audit until missing/parity issues are zero') plus JSON validation and a Validation Checklist, satisfying the batch-operation validation requirement.	5 / 5
Progressive Disclosure	Well-organized sections with a single one-level-deep, clearly signaled reference to the real `scripts/i18n_audit.py` (verified present and accurately described); minor gaps are the lightly overlapping Architecture/Failure/Performance sections that could be consolidated.	4 / 5
	Total	17 / 20 Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, specific description with an explicit 'should be used when' trigger and a comprehensive enumerated action list. Minor synonym coverage gaps keep trigger_term_quality just below maximum.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — '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' — giving comprehensive coverage of the i18n task space.	5 / 5
Completeness	Explicitly answers both 'what' (the enumerated setup/audit/enforce actions) and 'when' via the explicit trigger clause 'This skill should be used when setting up, auditing, or enforcing internationalization/localization...', satisfying the 'Use when...' requirement.	5 / 5
Trigger Term Quality	Strong natural terms ('internationalization', 'localization', 'i18n', 'i18next', 'hard-coded strings', 'pluralization', 'key parity') but misses common synonyms a user might say like 'translation'/'translating' and explicit locale-file extensions beyond 'JSON locales'.	4 / 5
Distinctiveness Conflict Risk	Occupies a clear niche (i18n/localization in UI codebases with specific framework/locale cues) with distinct triggers and minimal overlap with unrelated skills.	5 / 5
	Total	19 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: zebbern/claude-code-guide
Path: skills/localization-toolkit/SKILL.md
Commit: 59c5fc4

Reviewed: ~20 hours ago

Table of Contents

Discovery Implementation Validation

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.