Content
71%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 delivers highly actionable, executable guidance organized as a clear two-pass workflow with explicit boundary-review checkpoints. Its weaknesses are repetition between the Outcome Indicators and Pass 2 sections, and a broken core reference — the entire tool hinges on scripts/prioritize_issues.py, which is not present in the bundle.
Suggestions
Consolidate the duplicated material: the prescriptive-verb flags, stale-item (≥90-day) rules, and P0–P4 tier descriptions each appear in both 'Outcome Indicators' and the Pass 2 coaching sections — state them once and reference them.
Ship the referenced scripts/prioritize_issues.py in the skill's scripts/ directory (or inline the heuristic guidance as a fallback), since every 'How to Run' command depends on a file that is not in the bundle.
Add a finalization step to the two-pass workflow — how to record/apply the resulting labels (e.g., via gh issue edit or a --json report) and what to do when the Pass 1 script errors — to close the remaining workflow-clarity gaps.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with no padding of concepts Claude already knows, but noticeably redundant: prescriptive-verb flags appear twice ("flagged as smells" in Outcome Indicators vs. "Look for prescriptive verbs: build, create, implement..." in Pass 2), stale rules appear twice (the ≥90-day bullet vs. the "Address Backlog Rot" section), and the P0–P4 grid is described in Outcome Indicators and again across Pass 2 sections 4–5. Not a 2 because there is no fluffy over-explanation; not a 4 because the repetition is more than minor and could be consolidated. | 3 / 5 |
Actionability | Fully executable, copy-paste-ready commands covering the common cases ("python3 scripts/prioritize_issues.py --goals ...", "--no-auto-goals", "--repo owner/repo", "--json", "--limit 50 --stale-days 60") plus concrete Pass 2 guidance: a specific support-question example ("Is there a way to exclude X?"), named verb lists, and an outcome hypothesis template. This matches the top anchor. | 5 / 5 |
Workflow Clarity | A clearly sequenced two-pass workflow where Pass 2's six numbered checks act as explicit validation checkpoints with feedback actions ("Demote pure support inquiries from P0 to P2", "label it duplicate/hold and move to P4"). Not a 5 because there is no guidance on what to do if the classifier fails or errors, and no step for finalizing/applying the resulting labels or grid; not a 3 because checkpoints are genuinely present and specific. | 4 / 5 |
Progressive Disclosure | Section structure is well organized with clear headers and a logical overview-to-detail flow, but the core reference "scripts/prioritize_issues.py" does not exist in the skill's bundle (no scripts/ directory present), and the Source section points to "../../CREDITS.md" outside the skill. A load-bearing reference is broken, which is worse than the 'minor organization gaps' of level 4 but better than the unstructured level 2. | 3 / 5 |
Total | 15 / 20 Passed |