Content
57%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is well-structured and navigable with usable gh command examples, but several blocks are placeholder/pseudocode rather than executable guidance and merge workflows lack explicit validation checkpoints. It is solid but leaves actionability and workflow-clarity gaps.
Suggestions
Replace placeholder commands with concrete, copy-paste-ready examples (real --title/--body values and full flags) instead of '...'.
Add explicit validation checkpoints to merge workflows, e.g. 'Only run gh pr merge after `gh pr checks` reports all passing'.
Convert the prose pseudocode workflow lists into actual runnable bash steps or remove the ```bash fences from non-command numbered lists to avoid mislabeling.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient and well-sectioned, but the 'Common Commands' block uses placeholder args ('--title "..." --body "..."') and the workflow-pattern code fences contain numbered prose rather than code, adding padding that could be tightened. | 2 / 3 |
Actionability | It provides some concrete executable gh commands ('gh pr create --title ... --base main', 'gh pr merge --squash --delete-branch'), but several blocks are non-executable placeholders or pseudocode ('1. Create PR with detailed description') and key details like flags and reviewer assignment are missing. | 2 / 3 |
Workflow Clarity | Multi-step processes (Standard/Hotfix/Large Feature PR) are clearly sequenced as numbered lists, but these are prose pseudocode with no validation checkpoints for destructive/batch operations like merging, and the Error Handling section only describes issues rather than gating 'merge only when checks pass'. | 2 / 3 |
Progressive Disclosure | For a single-file skill under ~150 lines with no external bundle files, content is well organized into clear sections (Purpose, Workflow Patterns, CLI Integration, Best Practices, Error Handling) that support easy navigation, satisfying the simple-skill criterion for a top score. | 3 / 3 |
Total | 9 / 12 Passed |