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: dense research-backed findings, verified executable commands with documented exit codes, an explicit validation gate with feedback semantics, and clean one-level progressive disclosure to a complete bundle. No penalizable padding, teaching of known concepts, or dead references were found.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and dense: the four-lenses table delivers research findings Claude does not know ("Construction energy exceeds total query energy across 300 queries", "It is all KV cache in HBM"), the workflow block is bare commands, and nothing teaches known concepts. The three sentences of framing ("a memory engineer optimizes what it forgets") define the skill's core principle rather than pad. Every token earns its place. | 5 / 5 |
Actionability | Fully executable: the five-step bash block is copy-paste ready and every flag was verified against the scripts' argparse (--print-sample-spec, --spec, --constraints, --dir, --policy, plus --output json and --sample as claimed). Exit-code interpretation per script is given ("0 · 2 finding · 3 bad input", "0 PASS · 2 CONDITIONAL · 4 FAIL"), and input provenance is covered (step 1 generates workload.json; the fillable forgetting_policy_template covers F1–F8). | 5 / 5 |
Workflow Clarity | Clear 5-step sequence with explicit validation and feedback loops: "if construction dominates, cut construction tokens *before* touching retrieval", "on a tie it asks, exit 2", "Exit 4 is a stop, not a suggestion", a conditional skip ("skip if greenfield"), and a prove-by-hand-before-scheduling rule for step 5. Error semantics are defined by hard rule 6 ("A non-zero exit is a result to surface, not an error to swallow"). Not 4: checkpoints and error paths are explicit, not implicit. | 5 / 5 |
Progressive Disclosure | Scored against the actual bundle: all 4 references, 3 assets, and 4 scripts referenced in the body exist on disk, and references are one level deep — the body keeps only findings and exit codes while sources and section detail ("§7", "(7 sources)") live in the referenced files. Each reference gets a one-line scope description, and the "References and assets" section plus scripts table make navigation trivial. | 5 / 5 |
Total | 20 / 20 Passed |