Content
87%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 content is highly concise and actionable with executable gh commands and a clear two-pass pattern, and it is well-structured for a simple skill. The only gap is the absence of an explicit validation/feedback checkpoint for the batch scan, which caps workflow clarity.
Suggestions
Add an explicit validation step after Pass 1, e.g. confirm the surviving count and verify skip-rule correctness before hydrating, to introduce a feedback loop.
Document the error-recovery path when more than 30% survive Pass 1 (e.g. "re-tighten filters and re-scan before proceeding") as a concrete retry loop.
Optionally note how to handle `gh` failures or rate limits during hydration so the batch workflow degrades gracefully.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with no padding and no explanation of concepts Claude already knows; every section (commands, skip table, threshold rule) earns its place. Matches anchor 5. | 5 / 5 |
Actionability | Both `gh issue list` and `gh issue view` commands are copy-paste ready with exact JSON fields, plus a concrete decision table and a quantified 30% hydration rule. Fully executable and covers the common cases. | 5 / 5 |
Workflow Clarity | The two-pass sequence is clear and ordered, but this is a batch operation (scanning up to 100 issues) with no explicit validation/verification checkpoint or error-recovery loop, so the batch-operation cap of 3 applies. | 3 / 5 |
Progressive Disclosure | A single-file, well-organized skill under 50 lines with no external bundle references; per the simple-skills scoring note, that qualifies for a 5. | 5 / 5 |
Total | 18 / 20 Passed |