CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

tinyworld-i18n

Add, translate, or audit TinyWorld UI strings across English/French/Chinese/Spanish. Use when adding user-facing gameplay text, when `npm run i18n:check` fails, when a string shows up in English in a non-English locale, or when adding a new language. No translation API — Claude does the translating directly, using the established glossary for consistency.

72

Quality

90%

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

SKILL.md
Quality
Evals
Security

Quality

Content

88%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 process-oriented skill: fully executable guidance with exact file paths and commands, a validation-gated workflow with feedback loops, and clean section organization. The only soft spots are slight redundancy with the description in the intro and a monolithic ~100-line body where the glossary could optionally live in a reference file.

DimensionReasoningScore

Conciseness

The body is dense and operational — file paths, commands, and pattern snippets with no explanations of concepts Claude already knows. The only trimmable content is the opening paragraph restating "There is no external API: you (Claude) are the translator", which duplicates the description, fitting the 4 anchor (efficient with minor instances of over-explanation) rather than a flawless 5.

4 / 5

Actionability

Guidance is fully executable: exact paths (`engine/i18n/{en,fr,es,zh}.js`, `engine/world/19-tools-toolbar.js`, `tools/i18n-check.js`), runnable commands (`npm run i18n:report`, `npm run i18n:check`, `npm run dev`, `?lang=fr`), concrete patterns (`tx('prefix.' + item.id, item.label)`, `if (window.TWI18N)`, `<span data-i18n="key">`), and a copy-paste-ready six-step new-language recipe covering the common cases. No gaps; not the 4 anchor's 'minor gaps'.

5 / 5

Workflow Clarity

The main loop is a clear six-step sequence with explicit validation checkpoints and feedback loops: step 3's coverage report, step 5's "`npm run i18n:check` until it passes (it also runs inside `npm run check` / `publish.sh`...)", and step 6's real-app verification with `?lang=` per locale. The new-language workflow repeats the check-then-verify pattern. This matches the 5 anchor with error-recovery loops built in.

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), and the single-file body is well-sectioned with a clearly signaled one-level reference ("Read `docs/i18n.md` first if you need the architecture") for depth. It fits the 4 anchor: structure and placement are good, and while the glossary table is defensibly inline as core working content, a ~100-line body keeps it a notch below the 5 anchor's ideal content split.

4 / 5

Total

18

/

20

Passed

Description

87%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 a clear what, four concrete natural-language triggers, third-person voice, and a distinct project-specific niche. The only minor gaps are a few missing synonyms ("localization", "i18n") and supporting actions that are implied rather than enumerated.

DimensionReasoningScore

Specificity

"Add, translate, or audit TinyWorld UI strings across English/French/Chinese/Spanish" plus "Claude does the translating directly, using the established glossary" lists several concrete actions with a clear capability boundary. It falls just short of the 5 anchor because supporting actions (running the check loop, generating coverage reports) are only implied through the trigger mention of `npm run i18n:check`, and it sits clearly above 3's '1-2 concrete actions'.

4 / 5

Completeness

The description explicitly answers both: what ("Add, translate, or audit TinyWorld UI strings across English/French/Chinese/Spanish... Claude does the translating directly") and when ("Use when adding user-facing gameplay text, when `npm run i18n:check` fails, when a string shows up in English in a non-English locale, or when adding a new language") with four concrete trigger phrases. This matches the 5 anchor's shape exactly and clearly exceeds 4's 'when could be more explicit'.

5 / 5

Trigger Term Quality

Triggers "adding user-facing gameplay text", "when `npm run i18n:check` fails", "when a string shows up in English in a non-English locale", and "when adding a new language" are natural phrases users would say, including an untranslated-string symptom. A few natural terms are missing (e.g., "localization", "i18n", "locale" as user-spoken words), so it fits the 4 anchor rather than the comprehensive 5.

4 / 5

Distinctiveness Conflict Risk

The niche is unambiguous: project-specific ("TinyWorld UI strings"), locale set is named, and triggers reference project artifacts like `npm run i18n:check`, which no other skill would claim. Minimal conflict risk, matching the 5 anchor.

5 / 5

Total

18

/

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

jasonkneen/tiny-world-builder

Path

.claude/skills/tinyworld-i18n/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.