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 lean reference skill: every token is a rule, all guidance is copy-paste executable, and the structure maps directly onto the PR-creation workflow with an explicit label-validation step. Nothing in the body could be cut or needs to be added.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line is directive — title spec, template, label mapping, validation command, flags — with zero explanation of concepts Claude already knows. Even asides like 'Collapse trivial commits. Scannable in under 30 seconds.' are rules, not padding. | 5 / 5 |
Actionability | Fully concrete: an exact title pattern with enumerated types, a complete body template, an exhaustive commit-prefix→label mapping, a copy-paste `gh label list --json name --jq '.[].name'` validation command, and exact flags ('--draft --assignee @me'). | 5 / 5 |
Workflow Clarity | A simple, single-purpose reference skill whose sections (Title → Body → Labels → Flags) follow the PR-creation order unambiguously, and it includes an explicit validation checkpoint for labels ('Validate with gh label list... drop labels that don't exist'). No destructive or batch operation requires a feedback loop beyond that. | 5 / 5 |
Progressive Disclosure | The body is under 50 lines with no need for external references (none exist in the bundle) and is cleanly organized under four well-named section headers, matching the rubric's simple-skill exception for a top score. | 5 / 5 |
Total | 20 / 20 Passed |