Content
93%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 single-file skill body: fully executable commands, a safety-first preview/confirm flow for destructive audio deletion, and a gotchas section dense with non-obvious project knowledge. The only gap is the absence of a post-apply verification or error-recovery loop for the destructive and batch operations.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean throughout: short command blocks with terse comments, a two-line project-context intro, and a Gotchas section where every entry is non-obvious project-specific knowledge (pinned audio, sidecar stems, ~10 MB/minute, iCloud Recently Deleted). Nothing explains concepts Claude already knows, so every token earns its place. | 5 / 5 |
Actionability | Every task section gives fully executable, copy-paste-ready commands — "minutes cleanup --older-than 14d", the find/mv archive pipeline, "du -sh ~/meetings/memos/processed/", and the stale-state cleanup block — covering the common cases with flags explained inline. It is not below 5 since no pseudocode or missing-key-details gaps exist. | 5 / 5 |
Workflow Clarity | The destructive/batch operations have explicit checkpoints: "Present this to the user before taking any action", preview-only-until---apply semantics, and "Only apply cleanup after showing the preview and getting explicit confirmation". It misses 5 because there is no post-apply verification step or error-recovery feedback loop (e.g., checking that cleanup freed the expected space), though the preview-confirm pattern keeps it above 3's 'checkpoints missing' anchor. | 4 / 5 |
Progressive Disclosure | This is a single-purpose skill with no bundle files; all content (usage check, cleanup tasks, gotchas) appropriately belongs inline, and clear ## / ### section headers make navigation trivial. There are no nested or buried references, so nothing warrants moving to a separate file. | 5 / 5 |
Total | 19 / 20 Passed |