Content
92%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 lean skill body: executable verified commands, a clear interview-then-generate-then-prove workflow with explicit validation and fix loops, and appropriate delegation of detail to a real bundled script. The only gap is the absence of a concrete FACTORY.json command example.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Roughly 33 lines, every sentence is dense instruction ('Answer these from the checkout', 'A skill that was never executed is a draft') with zero padding and no explanation of concepts Claude already knows. Clearly matches the lean, every-token-earns-its-place anchor. | 5 / 5 |
Actionability | The core command is fully executable and verified real ('node <skill-dir>/scripts/write-verification-skill.mjs --code-root <code-root> --factory-root <factory-root> [--repo <repo-name>]'), the Drive section enumerates concrete surf commands, and FACTORY.json commands are specified at field level (name, argv, optional timeoutMs). Not a 5 because there is no copy-paste example of a completed FACTORY.json command entry and the semantics of --repo are only implied. | 4 / 5 |
Workflow Clarity | Clear sequence — interview the repo, generate files, replace placeholders with observed values, run once, confirm evidence survives cleanup — with an explicit validation loop ('Fix the skill if that fails. A skill that was never executed is a draft.') and an explicit checkpoint ('confirm the evidence file is still there'). Matches the anchor with explicit validation and error-recovery feedback. | 5 / 5 |
Progressive Disclosure | Under 50 lines with no need for external references: well-organized sections (## Interview, ## Prove one feature) and its single bundle reference (scripts/write-verification-skill.mjs) is real and correctly invoked, with the generated-skill detail appropriately delegated to that script. Per the rubric's simple-skill guidance this earns a 5. | 5 / 5 |
Total | 19 / 20 Passed |