Content
77%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 a well-structured, highly actionable PR-review workflow with strong sequencing and an explicit validation gate. Its main weakness is progressive disclosure: the per-dimension checklists point to external files that are absent from the bundle, so the detailed review criteria are unreachable.
Suggestions
Ship the referenced checklist files (backend-quality/*.md, frontend-quality/*.md, style/*.md) inside the bundle, or inline the key acceptance criteria so the links resolve.
For the outward-facing review submission, add a brief pre-submit checkpoint (e.g. 'Review the draft report and severity counts before posting') to guard the batch comment POST.
Drop the duplicated trigger-constraint block in the body since it already lives in the frontmatter description, trimming token cost.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean — concrete gh/git commands, dense checklists, a report template — with only minor padding such as repeating the trigger constraint (line 10) already stated in frontmatter and a somewhat long template. | 4 / 5 |
Actionability | Core mechanical steps are copy-paste ready (gh pr view/diff/checks, git worktree, the GitHub API review POST with full JSON), but the actual review criteria in phases 2-4 are delegated to referenced files that are not in the bundle, leaving gaps. | 4 / 5 |
Workflow Clarity | A clearly sequenced staged process (Step 0 → Phase 1 → parallel Phases 2-6 → report) with an explicit phase-gate feedback loop (skip to reporting if Phase 1 is blocked), per-phase checklists, and a severity/decision taxonomy. | 5 / 5 |
Progressive Disclosure | Structure is well organized and references are clearly signaled (checkbox + link), but the many referenced files (./backend-quality/*.md, ./frontend-quality/*.md, ./style/*.md, ../../../design/api/index.md) do not exist in the bundle, so navigation is broken. | 3 / 5 |
Total | 16 / 20 Passed |