Content
78%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 tight, mechanically specific instruction skill: exact tool calls, parameters, and dated incident evidence replace generic advice, and the checkpoint/stop/resume lifecycle is well sequenced with validation built in. The only weaknesses are minor — slight redundancy on the model-choice lever and two under-specified mechanisms (checkpoint file format, send_later arming).
Suggestions
Give the launch checkpoint a concrete location and minimal format (e.g. an exact scratchpad path and the fields run ID, script path, verbatim args) so the resume step is fully reproducible.
Show the actual send_later arming call (payload and delay) for the timed one-shot stop, since this is the mechanism the skill mandates when a threshold is named.
Collapse the repeated model-choice advice into one place — either 'Run the tail cheap' or the threshold-stop bullet — and trim the final bullet's justification to shorten the skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence (no concept explanations), but the model-choice lever is stated in both 'Run the tail cheap' and the final 'Never promise a threshold stop' bullet, and that final bullet is long enough to trim. | 4 / 5 |
Actionability | Concrete tool calls are given throughout — 'TaskStop', 'Workflow({scriptPath, resumeFromRunId, args})', 'journal.jsonl in the workflow transcript dir', 'send_later, e.g. 15–20 minutes out' — with exact failure modes (omitting args aborts, changed args miss the cache). Minor gaps keep it below 5: the checkpoint file's location/format ('scratchpad or session dir') and the send_later invocation are named but not spelled out. | 4 / 5 |
Workflow Clarity | The bullets follow the lifecycle order (checkpoint at launch → stop → resume → run tail cheap → journal check) and include validation checkpoints ('read the journal' before diagnosing lost work; 'say which one was done' before ending the turn). It sits at anchor 4 rather than 5 because there is no post-resume verification step confirming the resumed run completed and produced the expected output. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines with no bundle files and no need for external references, and is cleanly organized into 'Standing practice' and 'Related' sections; the two external pointers (`.claude/rules/workflow.md` rule 12, `~/.claude/CLAUDE.md`'s frontier gate) are clearly signaled and one level deep. Per the simple-skill guideline this merits 5. | 5 / 5 |
Total | 17 / 20 Passed |