Content
96%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: concrete commands at every step, explicit validation checkpoints, and disciplined scope control (file-only writes, no inventing labels/milestones). The single minor improvement is offloading the label/milestone taxonomy or issue body template to a reference file to slim the main SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and dense with original guidance — house title pattern, live label/milestone rules, sectioned body template, and explicit non-goals — with no padding explaining concepts Claude already knows. Every line conveys a Codewhale-specific rule or command. | 5 / 5 |
Actionability | Every workflow step ships executable commands (git rev-parse, grep, gh issue/pr/label list, gh api milestones, and a fully flagged gh issue create invocation), plus a concrete body-section template with example acceptance-criteria checkboxes and a worked example title. Fully copy-paste ready apart from intentionally live values. | 5 / 5 |
Workflow Clarity | Seven explicitly sequenced steps with built-in validation checkpoints: evidence confirmed from source before writing (step 1), duplicate check before filing (step 2), and live-set verification of labels/milestones (step 5), plus a red-flags section covering failure modes and scope limits for the single write operation. | 5 / 5 |
Progressive Disclosure | Well-organized single-file structure (When to use / Workflow / Red flags / Output) with no bundle files, and nothing that clearly demands splitting. However, at ~95 lines it exceeds the under-50-line simple-skill exception, and inline content like the label taxonomy and body-section template could live in a reference file, so it sits just below the top anchor. | 4 / 5 |
Total | 19 / 20 Passed |