Content
93%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: lean, highly actionable, with a clear lifecycle sequence, explicit checklists, and a closing anti-patterns section that sharpens judgment. The only gap is the absence of failure-path guidance (rebase conflicts, failing checks), which keeps workflow clarity at 4.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and directive throughout — it never explains what a PR is or how Git works, and every line prescribes behavior ('Imperative mood, under 70 characters', 'No trailing period'), so every token earns its place. | 5 / 5 |
Actionability | Concrete, copy-paste-ready guidance dominates: a complete fenced PR body template with Summary/Implementation notes/Verification/Risk sections, contrastive title examples ('Allow CSV export from reports table' beats 'Update reports.tsx'), and exact rules. Per the scoring notes, absence of code in an instruction-only skill is not penalized when guidance is this actionable. | 5 / 5 |
Workflow Clarity | A clear lifecycle sequence (branch hygiene → title → body → verification → review replies → merge checklist) with checkpoints ('Confirm tests, typecheck, and lint pass locally', the merge checklist) and a review feedback loop (push fixes, re-request review). It falls short of 5 only because there are no error-recovery branches for failures like rebase conflicts or red CI checks. | 4 / 5 |
Progressive Disclosure | The skill is a single self-contained file with well-organized sections (When to use / When not to use / per-phase sections / Anti-patterns) and no external references needed — no references/, scripts/, or assets/ bundles exist, so the well-organized-sections bar for a 5 is met. | 5 / 5 |
Total | 19 / 20 Passed |