Content
86%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.
A well-crafted, lean instruction-only skill: concrete commands, clear sequencing with a not-found recovery branch, and a report checklist. The only shortfalls are minor — no post-move/status verification and a couple of placeholder-dependent commands.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence: a one-line context sentence, an Inputs section, five numbered steps with concrete commands, and three Important bullets. It never explains concepts Claude already knows; the only trim candidates are trivial (the '$ARGUMENTS' marker appears in both the Inputs section and at the end, and one Important bullet restates the step-2 ordering as emphasis). | 5 / 5 |
Actionability | Gives executable guidance — 'find ... -name "<TASK_ID>.md" -not -path "*/done/*"', 'mkdir -p .../done', 'mv .../tasks/<priority>/<TASK_ID>.md .../tasks/done/' — plus a retain() template and a report template. Minor gaps keep it below a 5: the mv command relies on a '<priority>' placeholder resolved only implicitly from the find result, and 'retain(...)' is template syntax that assumes the Hindsight tool's exact calling convention. | 4 / 5 |
Workflow Clarity | A clear five-step sequence (find → update status → move → retain → report) with an explicit error-recovery branch ('If not found, check if it's already in done/ and inform the user') and a report template that doubles as a completion checklist. It is a single reversible file move rather than a destructive/batch operation, so no cap applies, but there is no verification that the frontmatter edit or the mv actually succeeded. | 4 / 5 |
Progressive Disclosure | A self-contained, single-purpose skill (~55 lines) with clean section structure (Inputs, Steps, Important) and no external references — none are needed at this size, and the inline commands and templates are appropriately placed. Per the simple-skill guidance, well-organized sections with no nested or buried references earn the top score. | 5 / 5 |
Total | 18 / 20 Passed |