Content
100%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.
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.
| Dimension | Reasoning | Score |
|---|---|---|
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 |