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.
The body is an exemplary lean, single-purpose skill: every step is concrete and executable, sequencing is clear, and structure is tight with zero padding. Its only weakness is a missing post-move verification step to guard against silently overwriting an existing same-named task in done/.
Suggestions
Add a post-move verification step, e.g. check `ls done/<TASK_ID>.md` or guard the `mv` with a test for an existing file in done/ before overwriting it.
Consider verifying the frontmatter status edit (e.g., grep for 'status: done') before moving the file, since a failed edit would leave a mislabeled task in done/.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | One short framing line ('You are completing a task from the devflow task backlog.') then pure instruction, commands, and templates with no explanations of concepts Claude already knows; every token earns its place. | 5 / 5 |
Actionability | Fully executable guidance throughout: a concrete `find` command with the real tasks path, `mkdir -p` + `mv` commands, the exact `status: done` frontmatter edit, a concrete `retain(...)` call, and a copy-ready report template; placeholders like <TASK_ID> are the expected input. | 5 / 5 |
Workflow Clarity | Five clearly sequenced steps with an error-recovery checkpoint for a missing task ('If not found, check if it's already in done/') and an input fallback, but there is no verification after the move (e.g., confirming no same-named file already exists in done/ that `mv` would silently overwrite), fitting 'most checkpoints present; minor validation gaps'. | 4 / 5 |
Progressive Disclosure | A short single-file skill (~56 lines) with no bundle files and nothing that belongs in a separate file; well-organized Inputs/Steps/Important sections make navigation trivial, satisfying the simple-skill exception for a top score. | 5 / 5 |
Total | 19 / 20 Passed |