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 skill: concise, fully actionable with concrete commands and templates, a clearly sequenced workflow with validation checkpoints, and clean single-file organization.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean throughout; assumes Claude's competence, provides only what isn't already known (house patterns, live label/milestone sets), and every section earns its place with no padding or basic-concept explanation. | 5 / 5 |
Actionability | Fully executable guidance — concrete `gh` commands, a title pattern with a worked example, and a sectioned body template with falsifiable acceptance-criteria checkboxes that are copy-paste ready. | 5 / 5 |
Workflow Clarity | Clear numbered sequence with explicit verification checkpoints (confirm the claim from source, check for duplicates) and falsifiable acceptance criteria; the only write is issue creation, with explicit guardrails against merging, closing, tagging, or releasing. | 5 / 5 |
Progressive Disclosure | Single well-organized SKILL.md under ~90 lines with no external bundle files; sections are clearly headed (When to use, Workflow, Red flags, Output) and all content sits at one navigable level. | 5 / 5 |
Total | 20 / 20 Passed |