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.
The body is a tight, executable runbook: exact commands, file paths, expected outputs, and an enforced human-review checkpoint for a destructive/batch operation. The only flaw is redundant restatement of the propose-before-apply safety rule across three sections, which costs a little token efficiency.
Suggestions
Consolidate the propose-before-apply safety rule into one place — e.g. keep the two 'Never' bullets but drop the duplicated framing in 'Mindset' and the 'Always propose before applying' lead-in, or merge the two --apply 'Never' bullets into one.
Optionally fold 'What happens' bullets for --propose/--apply into the Workflow steps so behavior and sequence live in one section, trimming a few more tokens without losing information.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence, but the propose-before-apply rule is stated three times — in 'Mindset' ('You never commit without reviewing the diff first'), 'Workflow' ('Always propose before applying'), and the first two 'Never' bullets, the second of which restates the first. Anchor 4 ('minor instances... that could be trimmed') fits; it is not 5 because of this redundant safety repetition, and not 3 since everything else earns its place. | 4 / 5 |
Actionability | Fully executable guidance: copy-paste commands ('vault-cli consolidate --propose [--project <id>]', 'vault-cli consolidate --apply'), the exact review file path ('00-inbox/consolidation-proposals.md'), the exact expected empty-output string ('No episodic memories found to consolidate'), and concrete status values ('approved or rejected', 'superseded'). Matches the 5 anchor for copy-paste ready commands covering common cases. | 5 / 5 |
Workflow Clarity | Clear 3-step sequence with an explicit mandatory validation checkpoint (Step 2 human review, enforced by 'Never run --apply without first running --propose' and 'Never run --apply without confirming the user has reviewed the proposals'), an edge-case guard (skip Step 3 on empty output), and a reject path (rejected proposals logged to audit). Despite involving batch/irreversible operations, validation is explicit, matching the 5 anchor. | 5 / 5 |
Progressive Disclosure | No bundle files exist and none are needed for a skill this size; the body (~50 lines) is well organized into clear sections (Mindset, When to use, Workflow, What happens, Important, Never) with no content that belongs in a separate file. Per the rubric's simple-skill guidance, this scores 5. | 5 / 5 |
Total | 19 / 20 Passed |