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 instruction-only skill: dense, rule-driven, and command-first, with triage that decides the path, explicit verification gates around every write, and clean one-level-deep delegation to the repo's i18n sources of truth. Every token earns its place.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~63-line body packs a triage section, two full workflow paths, finishing steps, and review handling with zero padding and no explanations of concepts Claude already knows (e.g., 'Never re-translate a whole document to apply an update — a minimal update preserves the reviewed phrasing of everything that didn't change'). Every sentence states a binding rule or a command, assuming the reader's competence. | 5 / 5 |
Actionability | Guidance is fully executable: concrete commands ('pnpm run gen-translation-brief --apply <pair>', 'pnpm run verify-translation-pairing --write <pair>', '--list', 'pnpm run doc-sync'), exact switcher-line formats ('[English](foo.md) | 中文'), explicit file paths, and precise terminology-column instructions for each target language. As an instruction-only skill, its guidance is copy-paste actionable. | 5 / 5 |
Workflow Clarity | Change-type triage routes to two clearly numbered paths, each with explicit validation checkpoints and feedback loops: '--apply' 'structure-validates the result before writing', step 5's record-then-verify sequence, 'the gate goes red if you forget', and escalation rules for unanswerable briefings. Batch recording is explicitly guarded ('it refuses to run bare so a bulk re-record is always an explicit --all'), so the destructive/batch cap does not apply. | 5 / 5 |
Progressive Disclosure | The body is a well-organized overview with clear triage-based navigation; detailed rules live one level deep in clearly signaled references, each introduced with its purpose ('the pairing contract', 'how to translate: faithfulness, structure preservation, terminology discipline…'). Nothing that belongs in a separate file is inlined, and no reference is buried. | 5 / 5 |
Total | 20 / 20 Passed |