CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

i18n-localization

Use when adding UI text, adding or shipping a language, reviewing translation files, or building i18n into an app. Checks missing keys, placeholders and CLDR plural forms with locale_sync.py, finds hardcoded strings with hardcoded_strings.py, and builds a pseudo-locale with pseudo_localize.py.

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is i18n-localization in alirezarezvani/claude-skills

SKILL.md
Quality
Evals
Security

Quality

Content

93%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.

An exemplary content body: executable commands with exit-code semantics, high-signal rules, and clean one-level progressive disclosure to real bundle files. The only weakness is that the error-recovery feedback loop (fix findings, re-run until the gate passes) is implied by blocking exit codes rather than stated as an explicit step.

DimensionReasoningScore

Conciseness

The body is dense with earned tokens: three copy-paste commands, per-step check descriptions, a hard-rules list, and an exit-code table, with no explanation of what i18n is or how the libraries work. The five-line failure-mode intro is the only framing text and it directly motivates the checks; the CLDR 49 mention is data provenance for the embedded plural table, not time-sensitive API guidance, so neither warrants dropping to a 4.

5 / 5

Actionability

"python scripts/locale_sync.py locales/ --source-locale en", "python scripts/hardcoded_strings.py src/", and the pseudo-locale commands are copy-paste ready with realistic paths and flags, and the table documents per-script exit codes plus --help/--sample/--output json. Adoption mechanics (--warn-only, i18n-ignore, .i18n-allow) cover the common legacy-codebase case, matching the fully-executable anchor.

5 / 5

Workflow Clarity

Steps 1-3 are clearly sequenced and each is itself a validation checkpoint with documented blocking exit codes ("0 · 2 warnings · 3 bad input · 4 blocked"), plus finding-handling guidance ("read each finding", "Mark gaps for a translator"). It is not a 5 because the fix-and-re-validate loop is only implied by the blocking exit codes — there is no explicit "fix issues and re-run until exit 0" instruction, and the pseudo-locale step's click-through lacks a structured checklist; it is well above a 3 because checkpoints are explicit and error-handling paths are written out.

4 / 5

Progressive Disclosure

SKILL.md is a 68-line overview whose three reference files (plurals_and_messages.md, string_routing_and_formatting.md, layout_rtl_pseudo.md) and two assets (i18n-gate.yml, i18n-allow.example) are each listed with a one-line description, verified to exist, and exactly one level deep; scripts expose further detail via --help/--sample. This matches the clear-overview, well-signaled, easy-navigation anchor with no inline content that belongs in a separate file.

5 / 5

Total

19

/

20

Passed

Description

88%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 explicit when-clauses and a comprehensive, tool-specific what-clause in third-person voice. Trigger coverage is good but misses natural synonyms (localization, l10n, translate) and the supported file extensions, and the broad 'adding UI text' trigger slightly raises conflict risk with adjacent frontend/copy skills.

DimensionReasoningScore

Specificity

"Checks missing keys, placeholders and CLDR plural forms with locale_sync.py, finds hardcoded strings with hardcoded_strings.py, and builds a pseudo-locale with pseudo_localize.py" names every concrete capability of the skill with its specific tool, comprehensively covering all three scripts. It is not a 4 because there is no discernible coverage gap — each action is specific and the list enumerates the full toolset, matching the comprehensive multi-action anchor.

5 / 5

Completeness

Explicitly answers 'when' with a concrete "Use when" clause listing four trigger scenarios, and 'what' with three named checking/generation actions. This matches the anchor that requires both what and when with concrete trigger phrases; a 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Triggers include natural phrases users would say: "adding UI text", "adding or shipping a language", "reviewing translation files", "building i18n into an app", plus "hardcoded strings" and "pseudo-locale". It is not a 5 because it omits common synonyms ("localization", "l10n", "translate") and file extensions (.po, .strings, strings.xml, ARB) that the skill actually supports; it is well above a 3 because the included keywords are varied and idiomatic rather than generic.

4 / 5

Distinctiveness Conflict Risk

The niche (translation-file integrity and i18n plumbing) is clear from "shipping a language", "reviewing translation files", and "building i18n", but the lead trigger "adding UI text" is broad enough to fire in general frontend or copywriting contexts, creating minor overlap with closely related skills. It is not a 3 because the dominant triggers are unmistakably i18n-specific, and not a 5 because of that broad first trigger.

4 / 5

Total

18

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

engineering/skills/i18n-localization/SKILL.md

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.