Content
71%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 highly actionable, well-structured operational skill whose CLI reference, tables, and concrete examples leave no ambiguity about what to run. Its weaknesses are redundancy (the agent-does-it rule appears four times), philosophy exposition Claude doesn't need, and a monolithic ~270-line body that inlines reference material (full CLI syntax, filter queries) a references/ file could hold.
Suggestions
Collapse the 'could the agent just do this' guidance, which currently appears in 'Personal action boundary', the 'Could the agent just do this?' section, the ADR SOP, and 'Anti-Patterns', into one authoritative section and reference it elsewhere; trim the GTD/Shape Up/Tiny Habits summaries to the one-line operational rule each contributes.
Move the full CLI command reference, priority/schedule/structure tables, and Todoist filter syntax into a references/ file (e.g. references/cli-reference.md) and keep SKILL.md as an overview with clearly signaled links, per progressive-disclosure best practice.
Add an explicit verification step before destructive operations (e.g. confirm delete/kill decisions with Joel, or verify the task was created with todoist-cli show after add) to close the workflow-clarity validation gap.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly operational and tight (command blocks, tables, rules), but the GTD/Shape Up/Tiny Habits philosophy summaries re-explain frameworks Claude already knows, and the 'could the agent just do this' rule is restated in four separate sections (Personal action boundary, 'Could the agent just do this?', the ADR SOP, and Anti-Patterns). This matches 'Mostly efficient but includes some unnecessary explanation or could be tightened'; it is not 2 because most sections are concrete rather than padded, and not 4 because the redundancy and philosophy exposition are more than minor. | 3 / 5 |
Actionability | Fully executable throughout: copy-paste-ready todoist-cli commands for read/write/add/complete/move/delete, a UI-vs-API priority table with agent rules, schedule and structure mappings, filter query examples, and concrete good/bad task examples. This matches 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases'. | 5 / 5 |
Workflow Clarity | The inbox triage, weekly review, and ADR-to-tasks workflows are clearly sequenced numbered steps with concrete commands, and the batch triage includes a checkpoint ('Present as a batch decision') with an auth-failure fallback. It is not 5 because destructive operations (delete, kill zombie projects) lack an explicit verify-before-acting or error-recovery step, and not 3 because the batch-decision presentation and fallback constitute present checkpoints rather than missing ones. | 4 / 5 |
Progressive Disclosure | The body is well-sectioned with clear headers but is a ~270-line single file: the full CLI command reference, priority/schedule/structure tables, and Todoist filter syntax are inline material that would fit naturally in references/ files, and no bundle files exist (only logo assets). This matches 'Some structure but could be better organized... content that should be separate is inline'; it is not 2 because headers and navigation within the file are good, and not 4 because there is no split of reference-heavy material out of the main file. | 3 / 5 |
Total | 15 / 20 Passed |