Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable with a well-sequenced, validated workflow and a clean one-level bundle structure. The main weakness is verbosity from restating warnings and DON'Ts in multiple sections.
Suggestions
Collapse the "Common Mistakes to Avoid" table into the existing CRITICAL/DO/DON'T callouts to remove duplicated guidance and shorten the body.
Trim the per-step "What this does" bullets that merely restate the script SYNOPSIS, keeping only details not derivable from the script itself.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient procedural guidance, but ~240 lines with repetition — the "Common Mistakes to Avoid" table restates the earlier CRITICAL/DO/DON'T blocks, and some "What this does" bullets echo the script headers. | 2 / 3 |
Actionability | Copy-paste-ready `pwsh` invocations, exact `gh issue edit` / `gh pr edit` syntax, a full parameter table that matches the script's real parameters, and a concrete markdown presentation template. | 3 / 3 |
Workflow Clarity | A clear 6-step sequence with validation checkpoints — scripts self-verify gh install/auth, an explicit reload loop via `-Skip`, and "only stop when query returns zero issues" — giving a proper feedback loop for a batch operation. | 3 / 3 |
Progressive Disclosure | Bundle scripts exist under scripts/ and are referenced inline at one level of depth (`.github/skills/issue-triage/scripts/…`); sections are well-organized with no nested reference chains. | 3 / 3 |
Total | 11 / 12 Passed |