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.

90

1.00x
Quality

86%

Does it follow best practices?

Impact

98%

1.00x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

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 clearly sequenced audit-fix-validate workflow and explicit validation feedback loops. The main weaknesses are mild redundancy across sections and a few high-level steps that lack concrete commands or snippets.

Suggestions

Trim redundancy: drop or merge the 'Core Capabilities' section into the workflow, and consolidate the duplicate placeholder/pluralization guidance from step 7 and 'Architecture Guidance' into one place.

Add concrete snippets for the vague steps — e.g., a minimal react-i18next provider wiring example and the exact install command per framework — to lift actionability to copy-paste readiness.

Fix the inconsistent sub-bullet indentation (the stray single-space bullets under 'Setup i18n baseline' and 'Validation Checklist') and consider moving the rg search patterns and architecture notes into a references/ file for cleaner progressive disclosure.

DimensionReasoningScore

Conciseness

The body is largely lean bullet-style guidance with no tutorials on concepts Claude already knows, but there is noticeable redundancy: the "Core Capabilities" section overlaps the workflow steps, and placeholder/plural guidance appears in both step 7 ("Keep placeholders consistent") and "Architecture Guidance" ("preserve {name}/{{name}} exactly"). This fits the efficient-with-minor-trimmable-instances anchor, not the every-token-earns-its-place anchor.

4 / 5

Actionability

Mostly executable: the audit invocation (`python scripts/i18n_audit.py --src ... --locale ...`), the two `rg` search commands, and `python -m json.tool` validation are concrete, with specific library picks and key patterns. Minor gaps remain — steps like "Wire the provider at the app root" and "Install packages" give direction without commands or snippets, keeping it below fully copy-paste-ready coverage.

4 / 5

Workflow Clarity

The Audit -> Fix -> Validate workflow is an explicitly sequenced 8-step process with a real feedback loop: step 8 says "Re-run the audit until missing/parity issues are zero", plus JSON validation and test updates. Validation checkpoints are explicit and the failure modes/checklist sections reinforce recovery, matching the top anchor — the batch string-replacement work is validated, so the destructive/batch cap does not apply.

5 / 5

Progressive Disclosure

Good structure: a well-organized single-file overview with the one bundle file (`scripts/i18n_audit.py`, verified to exist) referenced both in the workflow and in a Resources section, one level deep. It falls short of the top anchor because there are no reference files for the substantial inline guidance (architecture notes, search patterns), and a couple of sub-bullets are inconsistently indented (lines 43 and 123), slightly marring navigation.

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 description with an explicit trigger clause, concrete multi-action coverage of the i18n domain, and clear niche boundaries in third-person voice. Keyword coverage is good but omits a few natural synonyms like "i18n" and "translations".

DimensionReasoningScore

Specificity

The description 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 domain. It matches the anchor for multiple specific concrete actions rather than the anchor 4 case, which would require noticeable coverage gaps.

5 / 5

Completeness

It explicitly answers both questions: the what is the concrete action list, and the when is the explicit trigger clause "This skill should be used when setting up, auditing, or enforcing internationalization/localization in UI codebases". Both are present with concrete trigger phrases, matching the top anchor rather than anchor 4 where the 'when' is only loosely specified.

5 / 5

Trigger Term Quality

Good keyword coverage: "internationalization/localization", "React/TS", "i18next", "JSON locales", "hard-coded strings", "en-US/zh-CN", "pluralization" are natural phrases a user would say. A few common variations are missing — the standalone abbreviation "i18n", "translations"/"translate", and generic "locale files" — so it falls just short of the comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

The i18n/localization niche is well defined with distinct triggers (locale parity, pluralization, hard-coded string replacement) and named technologies (i18next, JSON locales), so it is unlikely to fire for unrelated skills. Minimal conflict risk, matching the clear-niche anchor.

5 / 5

Total

19

/

20

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 — 16 / 16 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.