Content
87%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured, concise skill that provides clear executable commands for reprioritizing tasks. Its main weakness is the lack of explicit validation steps — particularly checking that the task file exists before attempting modifications and verifying the move succeeded. The guard rails (don't move from done, skip if already at priority) are mentioned but not integrated into the step sequence as checkpoints.
Suggestions
Add an explicit validation step after the find command to handle the case where the task file is not found (e.g., 'If no file found, inform the user and stop').
Integrate the 'already at requested priority' check as step 1.5 between finding the file and updating frontmatter, rather than relegating it to the Important section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is lean and efficient. Every section serves a purpose — inputs, steps, constraints. No unnecessary explanations of what priorities are or how file systems work. The hardcoded paths are the only slight concern but they're necessary for the specific environment. | 3 / 3 |
Actionability | Provides fully executable bash commands for finding, moving files, and exact YAML frontmatter format to update. The example invocation and output template are concrete and copy-paste ready. | 3 / 3 |
Workflow Clarity | Steps are clearly sequenced (find → update → move → report), but there's no validation checkpoint — e.g., verifying the file was found before proceeding, confirming the frontmatter was correctly updated, or handling the case where the task file doesn't exist. The 'already at requested priority' check is mentioned but not shown as an explicit step in the workflow. | 2 / 3 |
Progressive Disclosure | This is a simple, single-purpose skill under 50 lines with no need for external references. The content is well-organized into clear sections (Inputs, Steps, Important) making it easy to follow. | 3 / 3 |
Total | 11 / 12 Passed |