Content
82%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 well-built operational skill body: tight token-efficient policy statements, executable gh commands, a concrete output template, and a mode-gated two-phase workflow with a pre-mutation conflict checkpoint. The main gaps are the total delegation of ranking criteria to an external, non-bundled MAINTAINERS.md and a couple of vague fallback steps in the Start workflow.
Suggestions
Inline a minimal fallback ranking rubric (e.g., the gate/order/readiness criteria in brief) so the skill still produces defensible rankings when MAINTAINERS.md is unavailable, and move the policy reference into a bundled references/ file with the repo path as a secondary pointer.
Make start-step 4 concrete: name the default mechanism (e.g., self-assign the issue via gh or comment with the intended scope) and define what to do when the repository has no such mechanism.
Add an explicit recovery branch after 'report the conflict before mutating GitHub' — e.g., stop and await a new explicit selection, or re-run the poll excluding the conflicting claim — so the workflow has a feedback loop rather than a dead end.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and imperative throughout — "Do not equate age, reactions, or comment count with priority", "Preserve contributor authorship", and the compact candidate-card template each state policy in minimal tokens, and nothing explains concepts Claude already knows (no primer on what issues or PRs are). Every section earns its place; the one code block is four copy-paste gh commands with exact --json field lists. Not a 4 because I found no trimming candidates that would remove real guidance. | 5 / 5 |
Actionability | Concrete guidance dominates: executable gh commands with exact JSON field selections, a copy-paste candidate-card template, and specifics like "Return three to five 'Recommended now' cards by default" and "exact ISO 8601 polling time with timezone". Not a 5 because the skill's core ranking logic is delegated entirely to an external MAINTAINERS.md (only the ladder step names are inlined, no fallback criteria), and "Prefer a configured GitHub integration; use gh when it provides the required repository context" leaves the tool-choice decision vague. | 4 / 5 |
Workflow Clarity | Both workflows (Poll: 6 steps; Start: 6 steps) are clearly sequenced with real checkpoints — poll step 5 requires deep verification of each candidate, and start step 2 gates mutation: "If the recommendation is stale, the scope is ambiguous, or another active claim appeared, report the conflict before mutating GitHub". Not a 5 because there is no recovery branch after reporting a conflict (re-poll? abort and await re-selection?), and start step 4's "the repository's normal assignment or scope confirmation mechanism" offers no concrete default action or fallback. | 4 / 5 |
Progressive Disclosure | Sections (Poll, Poll Safety, Candidate Format, Start, Never Auto-Dispatch) are well-organized, inline content (gh commands, card template, safety rules) is appropriately sized for the body, and the one deep-reference policy is one level away with its role stated ("MAINTAINERS.md as the ranking policy") and its ladder summarized inline. Not a 5 because that sole reference points outside the skill bundle via a repo-relative path (../../../docs/contributing/MAINTAINERS.md) that breaks when the skill is installed standalone, and no reference bundle exists alongside the skill to carry that content. | 4 / 5 |
Total | 17 / 20 Passed |