Content
68%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 highly actionable, well-structured skill with exact commands, a verified parameter table, and a clear step-by-step triage workflow. Its weaknesses are repeated do/don't guidance across three sections and the absence of any validation/verification step after the batch gh edit operations, which caps workflow clarity at 3 despite an otherwise excellent sequence.
Suggestions
Add a validation checkpoint after each triage decision (e.g., verify the gh issue edit exit code or re-query the issue to confirm the milestone applied) before presenting the next issue.
Deduplicate the do/don't guidance: keep the "Common Mistakes to Avoid" table and trim the inline DON'T/DO lists in Steps 2 and 6 to a single-line pointer.
Use bundle-relative script paths (scripts/query-issues.ps1) or state explicitly that the .github/skills/issue-triage/ prefix is the deployed location, so the commands resolve regardless of where the skill is invoked from.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient — commands, parameter tables, and templates earn their tokens and no space is spent explaining concepts Claude already knows — but the same do/don't guidance is repeated three times (inline DON'T lists in Steps 2 and 6, plus the "Common Mistakes to Avoid" table), and phrases like "that need attention"-style filler and repeated "What this does" blocks could be tightened. This fits the "mostly efficient but includes some unnecessary content" anchor rather than the noticeably-padded level-2 anchor, since the repetition is brief and in service of a misbehavior-prone agent workflow. | 3 / 5 |
Actionability | Fully executable throughout: exact pwsh invocations with parameters ("pwsh .github/skills/issue-triage/scripts/query-issues.ps1 -Limit 50 -OutputFormat triage"), ready-to-run gh commands with clearly-marked placeholders ("gh issue edit ISSUE_NUMBER --repo dotnet/maui --milestone \"Backlog\""), a complete one-issue presentation template, a verified parameter table whose values match the actual script's param block, and a concrete milestone-suggestion decision table. This matches the copy-paste-ready anchor covering the common cases. | 5 / 5 |
Workflow Clarity | The six-step sequence (init → query → present one → await decision → next → auto-reload with -Skip) is unambiguous and would otherwise merit 5. However, the workflow performs batch edits against live repo state (gh issue edit / gh pr edit) with no validation or verification step — no check that the edit succeeded before advancing to the next issue, no error-recovery loop — so workflow clarity is capped at 3 per the destructive/batch-operation rule. The scripts' built-in gh-availability check does not substitute for verifying the edit outcome. | 3 / 5 |
Progressive Disclosure | Good single-file structure with clearly sectioned content, and every referenced script (init-triage-session.ps1, query-issues.ps1, record-triage.ps1) exists in the scripts/ bundle with parameters matching the documented table, so navigation is real. Minor gaps keep it below 5: the body uses deployment paths (".github/skills/issue-triage/scripts/...") rather than the bundle-relative scripts/ paths, and reference material like the Label Quick Reference and Example Session Output is inlined rather than split out, though at ~240 lines this is a defensible choice. | 4 / 5 |
Total | 15 / 20 Passed |