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: the shared hermetic-init abstraction is stated once, vendor mechanics are pushed to real, well-signaled reference files, and what remains inline is executable and dense. The routing table in particular delivers high value per token.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean throughout — a routing table, a terse five-step pattern, compact code, and table-formatted anti-patterns with no padding. The Overview earns its tokens by stating the non-obvious unifying insight ('ships the same hermetic-test mechanism under a different name'), not by explaining concepts Claude already knows. | 5 / 5 |
Actionability | The routing table gives the exact offline switch and arm-pinning API for each vendor ('localMode: true', 'set_forced_decision', "authorizationKey: 'localhost'", 'bootstrap', 'is_development_mode'), and the worked Optimizely example is complete, executable Python covering the common case. Each anti-pattern row pairs a failure with a concrete fix. | 5 / 5 |
Workflow Clarity | The shared pattern is a clearly sequenced five-step checklist with explicit validation built in ('Determinism - the same user ID gets the same arm', 'Distribution - across many user IDs, more than one arm actually occurs'), and the anti-patterns table maps each failure mode to its fix. Not 4: no validation gaps remain — the two integrity tests and assert-on-keys-not-IDs rule are explicit checkpoints. | 5 / 5 |
Progressive Disclosure | SKILL.md is a genuine overview holding only the vendor-neutral pattern, with all seven bundle files verified to exist and directly linked one level deep (including the optimizely-recipes.md and split-io-example.md secondaries). Cross-links between references are lateral sibling links, so navigation never nests. | 5 / 5 |
Total | 20 / 20 Passed |