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: fully executable, tightly sequenced with validation checkpoints and error-recovery loops, and concise without assuming domain knowledge it shouldn't. Structure is clean and self-contained with one-level navigation only.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and command-driven throughout; the prose present is exclusively non-obvious gotchas (redirect-while-404 behavior, cross-repo restriction, branch race conditions) that Claude would not already know, with no padding of familiar concepts. | 5 / 5 |
Actionability | Every step gives copy-paste-ready executable commands — `gh pr view`, `node scripts/wait-for-preview-tarball.mjs`, `gh workflow run`, `gh run list` — with explicit placeholders and flags covering the common cases. | 5 / 5 |
Workflow Clarity | A 6-step sequenced workflow with explicit validation gates (validate tarball before dispatch, re-resolve PR after validation, verify run headSha) and clear feedback loops (timeout→abort, branch moved→return to step 2, headSha mismatch→stop). | 5 / 5 |
Progressive Disclosure | Self-contained body with clear sections (Scope, Inputs, Workflow, Completion Report, Related Skills) and only one-level references (Related Skills pointers, one external contributing-doc link); no nested references and no bundle files to organize. | 5 / 5 |
Total | 20 / 20 Passed |