Content
100%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.
An exemplary dispatcher-style SKILL.md: a lean router that resolves the target deterministically, routes to exactly one well-scoped workflow file, and stays out of the way. The heavy logic is appropriately delegated to two real, well-structured reference files whose destructive GitHub operations carry explicit validation, read-back verification, and idempotency safeguards.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 24-line body is a pure router — 'Resolve one GitHub pull request or issue, then load only its lightweight triage workflow' — where every line is routing logic, a disambiguation rule, a boundary, or a resource pointer. This matches the 5 anchor ('lean and efficient; every token earns its place'), not 4, because there are no instances of over-explanation to trim: even the repeated prohibitions ('Do not read the issue workflow', 'Do not triage both kinds in one invocation') are single-clause, load-bearing routing constraints. | 5 / 5 |
Actionability | Fully actionable instruction-only guidance: exact input handling ('$ARGUMENTS (if absent, use the target named in the conversation)'), a deterministic resolution rule ('For a bare number, resolve a pull request with that number first, then an issue'), an explicit fallback ('ask the user which PR or issue to triage'), and exact file paths with execution instructions ('read `references/pr-triage.md` completely, then execute it end to end'). This matches the 5 anchor; not 4 because every branch (bare number, unresolvable, PR, issue) has a specific, executable instruction with no gaps. | 5 / 5 |
Workflow Clarity | The routing sequence is clearly ordered (resolve input → determine type from GitHub metadata → read exactly one workflow file → execute end to end) with an explicit ambiguity checkpoint ('If no single target can be resolved, ask the user which PR or issue to triage'). The destructive GitHub operations are delegated to workflow files that contain explicit validation and feedback loops ('Read back every changed label, comment, or state before claiming it succeeded', idempotent publication, refresh-and-recheck if the head changed, create-issue-before-close ordering), so the missing-validation cap does not apply, and the simple-skill exception holds since the single routing action is unambiguous. Matches the 5 anchor; not 4 because checkpoints and error-recovery loops are explicit rather than merely mostly present. | 5 / 5 |
Progressive Disclosure | A lean overview routing to two one-level-deep references, both of which exist in the bundle (references/pr-triage.md, references/issue-triage.md), with navigation signaled twice — bold-labeled routing bullets and a Resources section with one-line descriptions ('lightweight contributor PR policy and reviewability triage'). Content is appropriately split per target type with no nested bundle references (files named inside the workflows are repository inputs, not bundle files). Matches the 5 anchor (clear overview, well-signaled one-level-deep references, easy navigation); not 4 because there are no organization gaps. | 5 / 5 |
Total | 20 / 20 Passed |