Content
92%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 excellent instruction-only skill body: terse, fully directive, with explicit validation and confirmation gates around every external write and a clearly sequenced workflow. The only minor gap is the absence of worked examples (e.g., a sample action record or preview payload) that would make the guidance copy-paste ready.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and entirely directive — no concept explanations, no padding, and no filler (e.g., "PRs are informational in v1.", "Reject is terminal locally."). Every sentence instructs and assumes Claude's competence, matching the anchor-5 ideal of every token earning its place. | 5 / 5 |
Actionability | Guidance is mostly executable: concrete paths (".agents/triage-duty/"), enumerated record fields ("repository, target, source report, ID, timestamp, disposition, reason, confirmed payload, and outcome"), a specific command ("apply --expected-preview"), and a enumerated v1 action list. It falls short of anchor 5 only because there are no worked examples of a record entry or a preview payload for the common cases. | 4 / 5 |
Workflow Clarity | The workflow is clearly sequenced (locate/validate → reject/defer → apply) with explicit validation checkpoints and feedback loops for external writes: "Before any external write, re-read the target and determine whether it materially changed", "Revalidate immediately before execution; changed payloads require a new preview and confirmation", and "mark applied only after verified success". The destructive/batch cap does not apply because validation is explicitly present. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines with no bundle files, and the body is well-organized into clear sections (Locate and validate / Reject or defer / Apply). All cross-references (e.g., [local-state rules], [Label Discovery], [`triage-issue`], the `/label-issue` skill) are one level deep and clearly signaled with descriptive anchors, so the simple-skill guideline for a top score applies. | 5 / 5 |
Total | 19 / 20 Passed |