Content
96%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.
An exceptionally disciplined operational skill: every instruction is an executable command or a precise rule, with re-read-before-write validation, an ordered situation dispatcher, and explicit escalation loops. The only structural nit is that a small amount of inline query detail could be moved to a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line is operational: exact gh commands with field lists ("gh pr view <n> --json number,state,headRefName..."), exit-code semantics ("exits with 1 when a check failed and 8 when checks are pending; those are results, not failed reads"), and terse rules with no concept explanations or padding. It fully assumes Claude's competence, matching the lean every-token-earns-its-place anchor. | 5 / 5 |
Actionability | Guidance is copy-paste ready: concrete gh CLI commands, a literal GraphQL query for review threads with paging, exact reply mutations ("addPullRequestReviewThreadReply(input: {pullRequestReviewThreadId, body})"), log-fetch endpoints, and concrete decision rules for each failure mode. Nothing is pseudocode or abstract, matching the fully-executable anchor. | 5 / 5 |
Workflow Clarity | The "Situations" section gives an ordered dispatch list ("Take the first that applies"), with explicit validation checkpoints ("Read both again before every write", "confirm HEAD is the head you read", "reproduce it before you dispose of it") and error-recovery loops (non-convergence escalation, rerun-once with a posted run id). The numbered invariants act as a checklist for a risky batch operation (pushes and comments), matching the clear-sequence-with-explicit-validation anchor. | 5 / 5 |
Progressive Disclosure | Sections are clear and well-ordered (inputs, reading, done, situations, invariants, doing the work, judgment) and the whole skill is appropriately self-contained with no buried references. It falls short of the 5 anchor because there is no reference structure at all — the multi-line inline GraphQL query and review-thread paging detail would sit equally well in a one-level-deep reference file, a minor organization gap. | 4 / 5 |
Total | 19 / 20 Passed |