Content
92%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 high-quality, self-contained workflow skill: executable commands end to end, a properly sequenced process with validation checkpoints and error-recovery paths, and clean single-file organization with a well-signaled policy reference. The PR-body guidance section is the only spot that could be tightened for token efficiency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean overall with no concept padding — every command block is tight and policy notes are repo-specific — but the PR-body prose ('A "why" should be included...' followed by 'Omitting the "why" should be used sparingly...') and the three-clause test-command rule are meandering and could be trimmed into fewer sentences, matching the 'efficient; minor over-explanation' anchor rather than 'every token earns its place'. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready commands cover the entire pipeline (git status --short, git switch -c, git add, git diff --cached --check, git commit, git push -u, gh pr create --draft --base canary, gh pr view --json) plus a filled-in PR body template with concrete section structure. | 5 / 5 |
Workflow Clarity | A clear 5-step sequence (inspect → branch → commit → push → PR) with explicit validation before mutating Git, a pre-commit check ('git diff --cached --check'), a duplicate-PR check ('gh pr view --head'), and feedback loops for error recovery (sandbox-escalation retries for lock/network errors, denied-approval handling). The destructive-operation validation cap does not apply since checks are present. | 5 / 5 |
Progressive Disclosure | A single, well-organized file with clear sections for the workflow, PR body, and recovery; the one external reference ('See "GitHub Pull Requests and Issues" in AGENTS.md for the full policy') is well-signaled and exactly one level deep, and no bulk content exists that would benefit from splitting into bundle files. | 5 / 5 |
Total | 19 / 20 Passed |