Content
77%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a strong, highly actionable skill with excellent executable examples and a well-structured PR creation workflow with validation steps. Its main weakness is including substantial project-specific conventions (branch naming, PR title formats, per-phase body templates) inline, which bloats the file and could be better organized into separate reference files. The core gh CLI guidance is efficient and practical.
Suggestions
Move branch conventions, PR title conventions, and per-phase PR body templates into a separate CONVENTIONS.md or TEMPLATES.md file, referencing them from the main skill with one-line links.
Trim the 'Why gh over MCP' section to a single line like '## Why gh over MCP\ngh outputs only requested fields (~10-50 tokens) vs MCP full JSON payloads (~500-2000 tokens).'
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The core gh commands and workflow are efficient, but the branch conventions table, PR title conventions table, and PR body templates per phase add significant bulk that is project-specific configuration rather than gh CLI skill content. The 'Why gh over MCP' section is brief and justified. The shell escaping rule is useful but the CORRECT/WRONG example is slightly verbose. Overall, there's meaningful content but noticeable bloat from project-specific conventions. | 3 / 5 |
Actionability | Nearly every section provides copy-paste ready bash commands with concrete examples. The full PR creation workflow is executable end-to-end with duplicate checking, the core commands use specific --json and --jq flags for minimal output, and the error handling table maps errors to specific fixes. This is highly actionable. | 5 / 5 |
Workflow Clarity | The full PR creation workflow has explicit numbered steps with validation (check for existing PR before creating, push before PR creation). The 'Always follow this order — never skip steps' instruction is clear. Error handling covers the main failure modes with specific remediation. The duplicate-check step serves as a validation checkpoint before the destructive-ish operation of PR creation. | 5 / 5 |
Progressive Disclosure | The content is a single monolithic file with no references to supporting files. The branch conventions, PR title conventions, and per-phase PR body templates could reasonably be split into a separate conventions or templates file. For a skill of this length (~150 lines of substantive content), the lack of any file splitting or cross-references is a minor organizational weakness, though the section headers provide reasonable internal navigation. | 3 / 5 |
Total | 16 / 20 Passed |