Content
82%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 well-constructed, highly actionable skill: correct copy-paste syntax for both shells, the exact corruption symptom that signals misuse, and a robust file-based fallback, all delivered without padding. The remaining gaps are minor — a slightly redundant closing summary and no explicit post-write verification step.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and operational — it assumes Claude knows what git/gh are and spends no tokens on background ('Prefer the PowerShell tool for shell commands on Windows, especially anything with quoting'; 'It runs Git Bash (POSIX sh), not cmd or PowerShell'). It falls short of the 5 anchor because the closing 'Rule of thumb' section largely restates guidance already given in the per-shell sections, and 'The trap: it is easy to type one shell's heredoc syntax into the other tool' duplicates the point made by the symptom section — minor trimming opportunities. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready commands cover the common cases: the PowerShell here-string `git commit -m @'...'@` block with the column-0 closing rule, the Bash `git commit -F - <<'EOF'` heredoc, `git commit -m "Subject" -m "Body paragraph."`, and `gh pr create --body-file path/to/body.md`. Each carries the critical literal-vs-expansion details (quoted delimiters, `@'` vs `@"`), matching the 5 anchor. | 5 / 5 |
Workflow Clarity | The decision flow is clear and unambiguous — default to PowerShell, use Bash only for POSIX work, with a symptom-diagnosis section ('A commit message or PR body comes out wrapped in literal characters... a lone `@` line at the very top and bottom') acting as an error-recognition checkpoint and a most-robust fallback (write a file, pass `--body-file` / `-F`). It sits below the 5 anchor because there is no explicit verify step (e.g., checking the committed message before pushing) and no fix-retry loop, only symptom identification; it is clearly above the 3 anchor's 'checkpoints missing or implicit'. | 4 / 5 |
Progressive Disclosure | Single self-contained file with well-organized, clearly headed sections (Default to PowerShell / Multi-line text / PR bodies and long content / Rule of thumb) and no external references — appropriate since the content is short and operational, so nothing is buried or nested. It misses the 5 anchor only because the body runs ~75 lines, above the under-50-line simple-skill exception, and the per-shell quoting recipes and the file-based fallback could plausibly live in a reference file if the skill grows. | 4 / 5 |
Total | 17 / 20 Passed |