Content
85%Reviews 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 executable commands, a complete parameter table, and a clearly sequenced workflow with explicit error/scope validation checkpoints, backed by a real bundle script. Its only weakness is mild redundancy in the Tips section, which restates the priority categories.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean with concrete commands and tables, but the Tips section re-explains each priority category already covered in "Priority Categories", and the "When to Use" trigger list plus repeated CRITICAL/IMPORTANT callouts add padding that could be tightened. | 2 / 3 |
Actionability | Quick Start gives copy-paste-ready `pwsh ...query-reviewable-prs.ps1` invocations with flags, the Script Parameters table enumerates every flag with values and defaults, and the referenced script bundle exists at scripts/query-reviewable-prs.ps1. | 3 / 3 |
Workflow Clarity | The three-step workflow is explicitly sequenced with validation checkpoints: script failure triggers STOP/report/retry, Step 2 checks for the read:project scope warning to surface, and Step 3 mandates presenting all categories with required columns. | 3 / 3 |
Progressive Disclosure | The body is a well-organized overview (When to Use, Quick Start, Parameters, Workflow, Tips) with a single one-level-deep reference to the bundle script at scripts/query-reviewable-prs.ps1, which exists; no deeply nested references and content is appropriately scoped to one file. | 3 / 3 |
Total | 11 / 12 Passed |