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 body: lean, concrete, and complete. It specifies exact transformation rules with worked examples, covers all three task modes, and closes with an explicit verification checklist and build-validation feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and instruction-dense — every sentence prescribes behavior ("Preserve heading hierarchy, lists, tables, qualifiers, and numeric values", "External URLs remain unchanged") with no explanation of concepts Claude already knows. It even tells the model to keep English concise, matching the top anchor. | 5 / 5 |
Actionability | Guidance is fully concrete: exact link mappings (`/guide/quick-start` → `/en/guide/quick-start`), a worked asset-path example (`../images/foo.png` → `../../images/foo.png`), literal markup (`> [!NOTE]`), a real value translation (`group-title="央视"` → `group-title="CCTV"`), the exact config file (`docs/.vitepress/config.ts`), and the verification command `pnpm run docs:build`. For an instruction-only skill this covers the common cases copy-paste ready. | 5 / 5 |
Workflow Clarity | The three task modes (new page, update via diff, batch) are delineated up front, sections proceed logically from content to links to navigation, and completion has an explicit checklist ("complete translation, valid links/assets, and preserved example behavior") plus a build-validate-fix loop: "Run `pnpm run docs:build` ... Correct failures caused by the translation before finishing." Validation is present for batch work, so no cap applies. | 5 / 5 |
Progressive Disclosure | The short body is a well-organized overview with one clearly signaled, one-level-deep reference — [translation-memory.md](references/translation-memory.md), described with its purpose ("established terminology and alert conventions") and verified to exist — and the doc explicitly keeps that file limited to confirmed, reusable choices to prevent bloating. | 5 / 5 |
Total | 20 / 20 Passed |