Content
85%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 multi-mode review skill with explicit validation checkpoints and clean progressive disclosure. The main weakness is operational redundancy across safety/verification sections rather than any lack of substance.
Suggestions
Consolidate the repeated 're-read HEAD and git status before acting' guidance, which appears in Worktree Safety, Get the Diff, Autofix, and Verification, into one canonical rule with cross-references.
Merge the 'dirty or multi-agent checkout' warning, currently restated in Worktree Safety, Verification, and Get the Diff, into a single shared caution.
Tighten the Hard Stops lockfile sub-bullets into one sentence plus the regen command, rather than the current multi-paragraph treatment.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense and assumes Claude's competence with no basic-concept padding, but the 're-read HEAD/status before acting' rule and the 'dirty/multi-agent checkout' warning each recur across three to four sections and could be consolidated. | 3 / 5 |
Actionability | Copy-paste-ready commands throughout ('git status --short --branch -uall', 'gh run view <id> --json status,conclusion', 'pnpm update <pkg> --lockfile-only', 'cargo update -p <pkg> --precise <v>'), plus concrete depth/autofix tables and a filled sign-off template. | 5 / 5 |
Workflow Clarity | Sequenced mode flow with explicit validation checkpoints and feedback loops ('If the script exits non-zero... halt', 'If HEAD moved... stop and report') and a completion-ledger checklist, fully covering the destructive/batch operations the skill handles. | 5 / 5 |
Progressive Disclosure | Clear overview with well-signaled one-level-deep references (all eight referenced files exist under references/), content appropriately split into mode/catalog files, and a mode-picker table for easy navigation. | 5 / 5 |
Total | 18 / 20 Passed |