Content
86%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 tight, well-structured triage skill with a concrete output template and explicit validation/escalation rules. The main gap is the absence of concrete data-retrieval commands that would make it fully self-executing.
Suggestions
Add a short 'Retrieving state' snippet with the actual commands (e.g. `gh pr view`, `gh pr checks`, `gh pr review`) so the skill is fully executable without relying on inference.
Make the per-PR sequence explicit as a short numbered list (gather → classify → validate ready-to-merge → decide action) to surface the validation checkpoints already embedded in the rules.
Optionally fold the escalation thresholds (>4 days idle, high-risk labels) into the action-decision step so the validation loop is visually explicit.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and efficient ~40-line body with no padding and no explanation of concepts Claude already knows; every line is an output field or a decision rule. Not below 5 because there is no over-explanation to trim. | 5 / 5 |
Actionability | Provides a copy-paste output template with enumerated allowed values and concrete decision rules. Not a 5 because the data-gathering mechanics (e.g. gh pr view/checks commands) are implied rather than given; not a 3 because the guidance is concrete and specific, not pseudocode. | 4 / 5 |
Workflow Clarity | The template fields imply a clear per-PR sequence (checks → required-check policy → reviews → mergeability → blocking comments → ready-to-merge → action) and the 'Ready to merge' rule is an explicit validation checklist with escalation feedback loops. Not a 5 because steps are not framed as an explicit numbered sequence with explicit checkpoints; not a 3 because validation is genuinely present, so the batch-operation cap does not apply. | 4 / 5 |
Progressive Disclosure | Under 50 lines, self-contained, no bundle files in references/scripts/assets, and well-organized into 'Per-PR Output' and 'Rules' sections. Per the simple-skill scoring note, this earns a 5 with just well-organized sections and no external references needed. | 5 / 5 |
Total | 18 / 20 Passed |