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 SKILL.md body: lean, fully executable, and correctly structured as an overview over a bundled script. The dense provider/expectation table provides all specifics needed without any padding, and the manual path carries an explicit verification step.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section earns its place: a one-line quick-start command, a single manual-test snippet, a dense expectation table, and four reference links. No concepts Claude already knows are explained, and there is no padding. Matches the lean top anchor. | 5 / 5 |
Actionability | Commands are copy-paste ready ("./scripts/test-reasoning.sh" and a complete env-var invocation with FORGE_DEBUG_REQUESTS), and the coverage table gives exact config fields and expected JSON fields per provider/model. Fully executable with specific examples covering the common cases. | 5 / 5 |
Workflow Clarity | The primary path is a single unambiguous action (run the bundled script), and the manual path includes an explicit validation checkpoint ("Then inspect .forge/forge.request.json for the expected fields") plus a documented failure mode ("non-zero exit, no request written"). Under the simple-skill exception the single action is unambiguous with no sequence gaps. | 5 / 5 |
Progressive Disclosure | The ~500-line test logic is properly offloaded to the real bundle file scripts/test-reasoning.sh (verified present), which the body references by exact path. The body is a well-organized overview with clear sections, one-level-deep references, and easy navigation. Matches the top anchor for a bundle-backed skill. | 5 / 5 |
Total | 20 / 20 Passed |