Content
70%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.
The body is highly actionable, with concrete executable jq examples and an unambiguous single-step workflow. Weaknesses are the missing query-prs.sh script in the bundle, repeated statements of the --jq-optional behavior, and filler sections that could be trimmed.
Suggestions
Ship the referenced script (e.g. scripts/query-prs.sh) in the bundle or replace './query-prs.sh' invocations with the actual 'gh' commands so examples are executable as delivered.
State the '--jq is optional / schema-first' behavior once (the dedicated section) and remove the duplicate comment and options-list repetition.
Merge the thin 'Output Format' section into Usage and trim the Requirements line about jq being preinstalled.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient — the bulk is executable examples — but the '--jq is optional' point is repeated three times (its own section, the basic-query comment, and the options list), the 'Output Format' section is thin filler, and 'jq (installed by default on most systems)' pads the Requirements. Fits 'mostly efficient but could be tightened'; not 4 because the repetition goes beyond minor trimmable instances. | 3 / 5 |
Actionability | Every example is a copy-paste-ready command with concrete jq filters covering common cases (state, author, counts, review decision, labels). Not 5 because the target of every example, './query-prs.sh', is absent from the bundle, so the commands are not executable as shipped; not 3 because everything written is specific and complete. | 4 / 5 |
Workflow Clarity | A simple single-purpose skill where the single action (run query-prs.sh with options) is unambiguous, satisfying the simple-skill exception. The schema-first pattern (run without --jq to inspect structure, then a targeted query) acts as an implicit checkpoint, and the operation is read-only so no validation cap applies. | 5 / 5 |
Progressive Disclosure | The body is well-organized with clear sections, but the only bundle reference it makes — './query-prs.sh', invoked throughout — does not exist in the bundle (no scripts/ directory), so navigation to the actual tool is broken. Scored 3 rather than 4 because a broken primary reference is more than a minor organization gap; not 2 because the in-file structure itself is good. | 3 / 5 |
Total | 15 / 20 Passed |