Content
81%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 body is highly actionable and clearly sequenced, with executable commands, explicit checkpoints, and thorough failure-mode recovery. Its main weaknesses are the duplicated dependency-install step (steps 3 and 4 both run pnpm install), an inline time-sensitive date stamp, and a long inlined failure explainer that could be split out.
Suggestions
Merge the duplicated pnpm install instruction — it currently appears both at the end of step 3 ('After the worktree is created, install workspace dependencies there') and again as step 4 ('Install dependencies in the new worktree') — into a single step covering both the no-op-shared-node_modules case and the sandbox-escalation case.
Move the time-sensitive 'Verified working with the agent token (2026-05)' note out of the step body into a notes or verification section so it does not age the instructions inline.
Consider relocating the ~15-line project-board failure explainer (quoted user-facing message plus gh auth refresh snippet) into a small reference file linked from step 6, keeping SKILL.md's step list tighter.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean and free of concept explanations Claude already knows, but it instructs "pnpm install" twice — once appended to step 3 ("install workspace dependencies there so the branch is immediately runnable... Run it inside the new worktree path") and again as the entirety of step 4 ("Install dependencies in the new worktree... Run from the new worktree root") — duplicating an entire step. A time-sensitive stamp ("Verified working with the agent token (2026-05)") is also inlined rather than placed in a notes/deprecated section. This matches "mostly efficient but could be tightened" rather than level 4's "minor instances"; well above level 2 since there is no padded explanation. | 3 / 5 |
Actionability | Fully executable, copy-paste-ready commands cover every step: "gh issue view <N> --repo getlarge/themoltnet --json number,title,labels,state,url", "git fetch origin main; git worktree add -b issue-<N>-<slug> \"$WORKTREE\" origin/main", "gh issue edit <N> --add-assignee legreffier", and "gh project item-add 3 --owner getlarge --url ...", plus concrete branch-slug derivation rules and exact recovery commands for each failure mode. Not level 4: there are no gaps in covering the common cases. | 5 / 5 |
Workflow Clarity | Steps 1–7 are clearly sequenced with an explicit read-only vs. mutation phase split, validation checkpoints (stop if GH_TOKEN resolution returns empty, ask whether to proceed if issue state is closed, a single mutation-phase confirmation), error-recovery guidance in the failure-modes section, and a final 4-line hand-off checklist. Not level 4: checkpoints are explicit and complete rather than mostly present; the workflow involves no destructive or batch operations that lack validation. | 5 / 5 |
Progressive Disclosure | The skill is a single self-contained file with well-organized sections (Inputs, phased Steps, Failure modes) and no bundle files to reference, so navigation is easy and nothing is buried. Not level 5: at ~130 lines, with the ~15-line project-board failure explainer and its quoted user-facing message inlined, some content could arguably live in a reference file, and the sections-only exception applies to skills under 50 lines. Clearly above level 3 since the structure is good and clearly signaled. | 4 / 5 |
Total | 17 / 20 Passed |