CtrlK
BlogDocsLog inGet started
Tessl Logo

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 — Codex does the translating directly, using the established glossary for consistency.

77

Quality

96%

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

100%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 single-file process skill: dense with non-obvious project conventions, fully executable steps, and validation with real-app verification built into every workflow. Both workflows (string changes and new languages) end in check-plus-verify feedback loops.

DimensionReasoningScore

Conciseness

Every line carries project-specific operational knowledge Claude cannot know ("**`en.js` is authoritative.**", "reload-on-switch... Don't add live re-render wiring", "Use `window.t` (not bare `t`) inside functions that have a local variable named `t`"). There is no explanation of general concepts and nothing to trim, matching the lean anchor rather than the 4 anchor's "minor instances of over-explanation".

5 / 5

Actionability

Guidance is fully executable: exact commands (`npm run i18n:report`, `npm run i18n:check`, `npm run dev`, `?lang=fr`), exact file paths (`engine/i18n/{en,fr,es,zh}.js`, `tools/i18n-check.js`), concrete code patterns (`data-i18n="key"`, `window.t('key')`, `tx('prefix.' + item.id, item.label)` guarded by `if (window.TWI18N)`), and a copy-paste-ready new-language recipe (`cp engine/i18n/en.js engine/i18n/de.js`, change `g.en` → `g.de`).

5 / 5

Workflow Clarity

The six-step "loop" is clearly sequenced with explicit validation checkpoints and a feedback loop: step 3 reports what's missing, step 5 says "`npm run i18n:check` until it passes", and step 6 mandates real-app verification ("never claim done from files alone"). The new-language section repeats the check-then-verify pattern, matching the anchor-5 example with validation and retry built in.

5 / 5

Progressive Disclosure

The skill has no bundle files, and the body is a well-organized single file: focused sections (loop, scope, style, glossary, new language) with deep architecture correctly delegated one level deep ("Read `docs/i18n.md` first if you need the architecture"). Nothing that belongs in a separate file is inlined at burdensome length — the inline glossary table is exactly the content needed mid-task — so it meets the well-signaled, easy-navigation anchor rather than the 4 anchor with organization gaps.

5 / 5

Total

20

/

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: concrete verb-led capabilities, an explicit multi-trigger "Use when" clause, and heavy project-specific anchoring. The only gap is modest synonym coverage of the localization/L10n vocabulary.

DimensionReasoningScore

Specificity

"Add, translate, or audit TinyWorld UI strings across English/French/Chinese/Spanish" lists multiple concrete actions covering the skill's full remit, plus the glossary/no-API constraints. It sits at the comprehensive anchor rather than 4 because no meaningful capability in the skill's scope is left unlisted.

5 / 5

Completeness

It explicitly answers both questions: the what is "Add, translate, or audit TinyWorld UI strings across English/French/Chinese/Spanish" (with the no-API mechanism stated), and the when is a four-part "Use when..." clause with concrete triggers (adding gameplay text, `npm run i18n:check` fails, untranslated string, adding a new language). This matches the anchor-5 example structure; score 4 would require the when to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Natural phrases like "translate", "UI strings", "a string shows up in English in a non-English locale", "adding a new language", and the named languages give good keyword coverage, and "non-English locale" partially covers the locale vocabulary. It falls short of the 5 anchor because common synonyms like "localization"/"L10n"/"internationalization" are absent.

4 / 5

Distinctiveness Conflict Risk

"TinyWorld UI strings", the project-specific command `npm run i18n:check`, and the established glossary carve out a clear niche with distinct triggers and minimal conflict risk against generic translation or docs skills. It is not the 4 anchor because there is no plausible overlap with a closely related generic skill given the project naming.

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
jasonkneen/tiny-world-builder
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.