Content
75%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 lean, highly actionable instruction-only skill with concrete gh commands, an explicit output contract, and real validation checkpoints around the risky posting step. Its main gaps are minor: an unordered workflow, a rot-prone hard-coded default branch, and no use of reference files to shed detail from the main body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a dense operational policy that assumes Claude's competence (no explanations of gh, CI, or PR basics), with nearly every line carrying an instruction. Minor deductions: the version-specific fact "The repository's default branch is `2.x`" will rot, and a few packed multi-clause sentences could be trimmed. | 4 / 5 |
Actionability | Gives concrete commands (`gh pr view`, `gh pr diff`, `gh pr comment <number> --repo <owner/repo> --body-file <file>`), per-directory check lists, and an exact comment structure with named verdicts. Not a 5 because some commands are named without the flags needed to execute them and the checks are described rather than fully specified. | 4 / 5 |
Workflow Clarity | Sections imply a clear sequence (context → fetch metadata → verify head SHA → review → compose → verify → post → return URL) with explicit checkpoints ("Immediately before posting, verify the PR is still open and its head matches the reviewed SHA") and a retry feedback loop ("inspect existing comments before retry to avoid duplicate comments"). Not a 5 because the ordering is never made explicit and some mid-workflow checkpoints are implicit. | 4 / 5 |
Progressive Disclosure | A single-file skill (~80 lines) with no bundle files and well-organized sections (Context and scope, Project-specific checks, Publish the result). Structure is good, but the per-directory check details and the comment template could live in one-level-deep reference files, and there is no overview-to-reference navigation. | 4 / 5 |
Total | 16 / 20 Passed |