Content
73%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 SKILL.md body is well-written: a tight four-step workflow with executable commands, explicit exit-code validation, and refusal-driven feedback loops. Its critical flaw is that the entire supporting bundle is missing — the three scripts the steps invoke, the three reference documents, and the two assets are all dead paths, so none of the promised material can actually be reached or run.
Suggestions
Ship the bundle: create scripts/shallow_work_auditor.py, scripts/time_block_planner.py, and scripts/focus_session_logger.py so the documented commands (and their exit-2 refusals) actually run, and verify each command example in the body against the shipped scripts.
Add the referenced detail files — references/deep_work_canon.md, references/time_blocking_method.md, references/shallow_work_budget.md, assets/example_time_block_plan.md, and assets/shutdown_checklist.md — or remove their links until they exist, since all eight referenced paths are currently dead.
Trim redundancy in the "Rules" section and "What this does": the 4-hour ceiling and two-batch rules are each stated four times; stating each once at its point of application would tighten the body without losing clarity.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean: four short steps with executable commands, a scripts table, and one-line reference descriptions — no explanations of concepts Claude already knows. It falls short of 5 because of mild redundancy: the 4-hour cap and two-window batching rule each appear four times ("What this does", Step 2, the scripts table, and "Rules"), and the "Rules" section largely restates constraints already stated where they apply. | 4 / 5 |
Actionability | The guidance itself is concrete and complete — copy-paste bash invocations with realistic argument values ("--task 'Write investor update:60' ... --budget 50"), documented exit codes ("OVER-BUDGET (exit 2)"), subcommands (log/status/streak), and stated refusal behaviors. It is not 5 because "fully executable, copy-paste ready" fails in practice: the three invoked scripts do not exist in the bundle, so every command errors on first run. | 4 / 5 |
Workflow Clarity | The four steps (classify → block → log → shutdown) are clearly sequenced with explicit validation checkpoints and error-recovery feedback: "OVER-BUDGET (exit 2) means cut, batch, or delegate before any schedule is built" and the two planner refusals that "name what to defer" / "name what to drop — the day never silently extends". This matches the 5 anchor (explicit validation steps plus feedback loops for error recovery) and exceeds 4, whose defining gap ("minor validation gaps") is absent. | 5 / 5 |
Progressive Disclosure | The in-body structure is well signaled — a references table, an assets list, and one-level-deep links like [references/deep_work_canon.md] with one-line descriptions — but the actual bundle is empty: no scripts/, references/, or assets/ directories exist, so all eight referenced paths are dead links. Scored against the actual bundle structure per the rubric guidelines, navigation to the detail material is impossible, fitting the 2 anchor (references effectively unusable); it is not 3 because the problem is not organization of the text but total absence of the referenced files. | 2 / 5 |
Total | 15 / 20 Passed |