Content
86%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 lean, highly actionable policy document: the acceptance-criteria gate is defined with concrete valid/invalid examples, exact status strings, and a copy-paste issue template, and the workflow includes an explicit blocking checkpoint with a feedback loop. The only gaps are minor: the gh command invocation is never shown and the done/verified-with-evidence step lacks a method.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body contains only skill-specific policy (gate rule, required sections, status semantics) with no padding or explanation of concepts Claude already knows; the only repetition — the field list inside the template — is justified as a copy-paste artifact. Every token earns its place. | 5 / 5 |
Actionability | Concrete throughout: `gh issue create` is named, a full body template is provided, valid/invalid acceptance-criteria examples are given, and exact strings for statuses and the execution-gate line are specified. Not 5 because the actual `gh issue create` invocation (title, flags, body-file handling) is only mentioned, never shown. | 4 / 5 |
Workflow Clarity | The sections follow the natural sequence (define fields → create → gate → set status → handoff) with the acceptance-criteria gate as an explicit checkpoint and a feedback loop ("If issue is `draft`, stop and request user-provided acceptance criteria"). Not 5 because terminal verification is underspecified — "`done`: acceptance criteria verified with evidence" names no evidence method, and how the gate becomes `allowed` is only implied. | 4 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, and assets/ are absent) and none are needed: the ~81-line body is core policy with no reference-grade bulk, organized under clear, well-ordered section headers and free of buried or nested references. This matches the simple-skill pattern of a well-organized single file scoring full marks. | 5 / 5 |
Total | 18 / 20 Passed |