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 instruction-only skill body: lean, dense with project-specific policy, fully actionable with concrete commands and an exact output format, and a well-gated workflow with authorization checkpoints and feedback loops. External detail is appropriately deferred to one-level references.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~30-line body is pure directive with no concept explanations; every line carries project-specific policy such as "the general issue lifecycle uses `state:*` labels, but their exact names may change" and "Do not infer that a label alone authorizes bulk changes." It assumes Claude's competence and every token earns its place. | 5 / 5 |
Actionability | The guidance is fully executable for an instruction-only skill: a copy-paste-ready `gh issue view <id> --json number,title,body,state,labels,author,comments` command, an exact comment prefix `> **📋 triage-agent**`, per-type checks for bugs/features/UX proposals, and an enumerated outcome taxonomy (confirmed bug, feasible feature, missing evidence, duplicate, already-fixed, expected). Common cases are concretely covered. | 5 / 5 |
Workflow Clarity | A clear 7-step sequence with explicit validation and feedback loops: authorization gate before batch label/comment changes ("show the issue count and a sample of titles and obtain explicit authorization"), conditional handling for absent user stories and failed reproductions, and an uncertainty branch recommending `create-spike`. The batch-operation cap does not apply because validation checkpoints are present. | 5 / 5 |
Progressive Disclosure | Under 50 lines with well-organized sections ("Scope and authorization", "Assess one issue") and clearly signaled one-level-deep references to CONTRIBUTING.md's labeling section and the `/label-issue` skill; no nested reference chains and no content that should be split out. | 5 / 5 |
Total | 20 / 20 Passed |