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 workflow skill body: a tight four-phase sequence with concrete commands, explicit error-path handling (diverged base, missing dependencies, invalid issues), validation checkpoints, and clear ownership boundaries delegated to open-pr. It is lean, actionable, and well organized with no padding or redundant explanation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Roughly 35 lean lines where every instruction is actionable; it explains nothing Claude already knows, and the one explanatory parenthetical ('Plain `gh issue view <n>` may fail on Projects-classic GraphQL — prefer the `--json` form') is non-obvious, earned knowledge — matching the 'every token earns its place' anchor. | 5 / 5 |
Actionability | Provides copy-paste-ready commands (`gh issue view <n> --json title,body,state,labels,comments,author,createdAt` and the full `git checkout <base> && git pull --ff-only && git checkout -b <type>/<n>-<short-slug> <base>` sequence) plus a concrete branch-name example (fix/2348-dts-in-source); the implement phase's absence of code is inherent to the task and its guidance remains concrete. | 5 / 5 |
Workflow Clarity | Four clearly sequenced phases (understand → branch → implement → hand off) with explicit validation checkpoints: confirm the approach before behavior-changing edits, stop and surface on `--ff-only` failure, run tests/typecheck with honest reporting when dependencies are absent, and explicit regression reasoning. Matches the anchor-5 sequence-with-validation pattern; no destructive/batch cap applies. | 5 / 5 |
Progressive Disclosure | Under 50 lines with no external reference material needed, so a single well-organized file with numbered sections is the correct structure per the rubric's simple-skill note; cross-mentions (open-pr, verify, code-review) are skill invocations that clarify ownership, not buried file references. | 5 / 5 |
Total | 20 / 20 Passed |