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 body: lean prose with zero padding, fully executable commands and tool calls, a seven-step workflow with explicit plan-fail-fix-retry and verification checkpoints, and clean two-file progressive disclosure verified against the actual bundle. No dimension showed anchor-level deficiencies.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body explains nothing Claude already knows and every rule carries its justification in a single clause ("Installs can outlast tool timeouts, so create with `install: false` and install as a separate step"). All value enumerations and payloads are deferred to references, so every token earns its place — anchor 5, not 4, since no over-explanation to trim was found. | 5 / 5 |
Actionability | Guidance is executable end to end: "npx create-better-t-stack@latest schema --name createInput", "`bts_create_project` with `install: false`", '`create-json` with "dryRun": true', and "Run `<packageManager> install` in the new folder", with the full copy-paste payload in references/cli.md. Anchor 5; the few deliberately generic spots ("typecheck or build script from its package.json") are appropriately flexible rather than gaps. | 5 / 5 |
Workflow Clarity | Seven sequenced steps include an explicit feedback loop ("If the plan fails, its error names the conflict. Fix the config and plan again"), a user checkpoint ("Show the user the planned stack and get a yes"), and post-create verification ("Prove it runs... If a step fails, report the exact error"). This matches anchor 5's explicit validation and error-recovery loop; the skill creates new directories rather than performing destructive/batch edits, so the cap of 3 does not apply. | 5 / 5 |
Progressive Disclosure | A concise overview body splits detail into two one-level-deep references, each clearly signaled with its contents: "[references/options.md] lists the values and the common compatibility rules" and "[references/cli.md] has the full `create-json` payload, the flag form for a command the user pastes, and the Stack Builder URL keys". Both files exist and contain exactly what is claimed, matching anchor 5's well-signaled, appropriately split structure. | 5 / 5 |
Total | 20 / 20 Passed |