Content
57%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 largely action-oriented, executable workflow guide whose strengths are concrete commands and safety confirmations. It is held back by broken step numbering with a menu/option mismatch, padded guard sections, and a fully monolithic structure with no progressive disclosure despite an external-file reference that doesn't resolve.
Suggestions
Fix the step numbering — the body has two Step 4s and two Step 5s ('Step 5: Present Options' precedes 'Step 4: Execute Choice') — and align the menu's option numbers with the execution headings (menu says 1 = Create PR, but the section 'Option 1: Merge Locally').
Remove or merge the redundant sections (Execution Contract, Red Flags, Common Mistakes, The Bottom Line) — the rules they restate are already enforced at the point of use inline.
Either bundle the referenced host-adapter and option-specific details as real reference files (e.g., references/options.md) or delete the dangling 'skills/blocks/codex-host-adapter.md' pointer, since no such file ships with this skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly command-driven and terse, but contains padded sections that add little Claude doesn't already know: the 'Execution Contract (MANDATORY)' block, the 'Red Flags' and 'Common Mistakes' tables that restate rules already enforced inline, and the redundant 'The Bottom Line'. This matches 'Mostly efficient but includes some unnecessary explanation or could be tightened'; not 4 because the padding spans several sections, not minor instances. | 3 / 5 |
Actionability | Most steps ship concrete, executable bash (test detection cascade, merge-base diff commands, worktree cleanup), matching 'Mostly executable guidance; concrete code or commands with minor gaps'. Not a 5 because several spots are placeholders rather than runnable: 'npm test # or appropriate test command', '# Prepend to CHANGELOG.md if it exists', PR_TITLE/CHANGE_SUMMARY enforced with :? but never defined, and a fabricated PR URL 'https://github.com/owner/repo/pull/123'. | 4 / 5 |
Workflow Clarity | Validation checkpoints exist where it matters (tests must pass before proceeding; typed 'discard' confirmation for deletion), so the destructive-operation cap isn't the binding issue — but the sequence itself is incoherent: 'Step 5: Present Options' is followed by a second 'Step 4: Execute Choice' and a second 'Step 5: Cleanup', and the presented menu numbers 'Create PR' as option 1 while the execution section labels 'Merge Locally' as Option 1. This fits 'Steps listed but validation gaps; sequence present but checkpoints missing or implicit' territory — specifically, the numbering collision and menu/option mismatch break the sequence's clarity. | 3 / 5 |
Progressive Disclosure | The file is well-sectioned with headers and a Quick Reference table (some structure), but everything lives inline in one ~360-line SKILL.md with no bundle files: no references/, scripts/, or assets/ exist, and the one cited external path ('skills/blocks/codex-host-adapter.md') is not part of this bundle. That matches 'Some structure but could be better organized' rather than 4, since content like the four option walkthroughs and octopus integration could be split out, and there is no one-level-deep reference organization to reward. | 3 / 5 |
Total | 13 / 20 Passed |