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 tight, executable procedure document: every step carries a concrete command, non-obvious constraints are captured, and validation/feedback loops are present at the risky points (branch switching, commit identification, empty cherry-picks). The only soft spot is the under-specified verification commands in step 6.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence with git/gh/pnpm, spending its tokens only on non-obvious repo knowledge (the build-all exception, `-x` for provenance, the LTS branch selection policy, empty-cherry-pick handling); no sections explain concepts Claude already knows, fitting the 'every token earns its place' anchor. | 5 / 5 |
Actionability | Steps 1–5, 7, and the PR templates are copy-paste ready with clearly marked placeholders (<pr-number>, <target-branch>), but step 6's verification guidance ("the relevant integration test mode for behavior changes") leaves the actual Next.js test commands unspecified — a minor gap consistent with the score-4 anchor rather than full coverage of the common cases. | 4 / 5 |
Workflow Clarity | Seven clearly sequenced steps include explicit validation checkpoints — pre-flight `git status`/branch inspection, cross-checking mergeCommit against `git log --grep` with subject verification, a conflict-resolution policy, an empty-cherry-pick feedback loop (verify already-present and report instead of duplicating), and a dedicated verification step — matching the score-5 anchor with error-recovery loops. | 5 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent) and none are needed: this single-purpose skill is well organized into Inputs / Workflow / PR Shape / Related Skills sections, with clearly signaled one-level pointers to related skills ($create-pr, $pr-status-triage) and no content wrongly inlined. | 5 / 5 |
Total | 19 / 20 Passed |