Content
85%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: a tightly sequenced method with built-in validation checkpoints and an explicit exit condition, concrete output formats and file conventions, and terse anti-patterns that assume the model's intelligence. The only real improvement space is adding a one-line worked example of the ledger output and trimming a couple of rationale sentences.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence throughout — no basic-concept explanations, no padding — with every rule stated as a terse imperative. It is not a 5 because a few lines spend tokens on rationale rather than instruction (e.g., "This is what stops the agent from using twenty words where one will do next session"), and not a 3 because such instances are minor and isolated. | 4 / 5 |
Actionability | Concrete, executable guidance for an instruction-only skill: exact ledger format ("Decision - Choice - Source (user | inferred: <path>)"), a concrete file location and collision-avoidance rule for decision records ("docs/decisions/NNNN-slug.md... number from the highest existing record"), and DEFERRED semantics. It falls short of 5 only because no worked example of a ledger line or a sample question is given; it is above 3 because the guidance is specific and directly executable, not pseudocode. | 4 / 5 |
Workflow Clarity | The seven-step Method is clearly sequenced with dependency ordering, explicit validation checkpoints ("Do not proceed on a mis-restatement"; "Before asking, check whether the answer already lives in the codebase"), feedback loops (the user confirms, picks another option, or pushes back), and an unambiguous exit criterion ("Exit only when zero nodes are open"). This matches the top anchor's sequence plus validation plus error-recovery loop; the operations are non-destructive so no additional validation cap applies. | 5 / 5 |
Progressive Disclosure | The skill is self-contained with no bundle files (references/, scripts/, assets/ do not exist) and nothing inlined that belongs in a separate file; sections (Method, Anti-patterns, Outputs, Output contract) are well organized and easy to navigate. No nested or dangling references exist, fitting the top anchor's appropriate content placement for a single-file skill. | 5 / 5 |
Total | 18 / 20 Passed |