Content
77%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
Highly actionable and operationally airtight content: complete executable tooling, a clear validated workflow, and thorough translation guidance. The weaknesses are repetition of the script-only mandate across multiple sections and the inlining of ~180 lines of utility scripts that would be better shipped as persistent bundle files.
Suggestions
Consolidate the 'never edit locale JSON directly, always use add-missing-keys.mjs' mandate into the single Hard Constraint section and reference it from the other sections instead of restating it six times.
Ship find-missing-keys.mjs, find-untranslated.mjs, and add-missing-keys.mjs as bundled scripts/ files so they persist and are simply invoked, rather than re-created inline on every run — this cuts SKILL.md to roughly a third.
Merge the Mandatory Preflight's source-text rules with the Translation Guidelines' Source Text Rules section to remove the duplicated guidance about not copying conversation text.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The three script listings are lean and load-bearing, but the script-only mandate is restated roughly six times (Hard Constraint, Small Fix Path, Step 4, Key Rules), and the Preflight rules duplicate the later Source Text Rules. Mostly efficient, but clear tightening opportunities keep it at anchor 3 rather than 4. | 3 / 5 |
Actionability | Fully executable guidance throughout: three complete copy-paste-ready scripts, exact commands ("cd web && bun run i18n:sync", "node scripts/add-missing-keys.mjs"), exact file paths, and a per-locale newKeys template covering all seven locales. | 5 / 5 |
Workflow Clarity | Clear 5-step sequence (sync/report, find missing, find untranslated, add, verify) with an explicit validation checkpoint and feedback loop — "verify: should say 'All t() keys found'" — satisfying the batch-operation validation requirement. | 5 / 5 |
Progressive Disclosure | No bundle files exist and section headers are clear, but ~180 lines of the body are three utility scripts the skill instructs to re-create each run ("Create and run `web/scripts/find-missing-keys.mjs`") — content that belongs in bundled scripts/ files is inlined, matching the 'could be better organized; content that should be separate is inline' anchor. | 3 / 5 |
Total | 16 / 20 Passed |