Content
88%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.
A strong operational skill body: concrete, executable commands dominate, the workflow is well sequenced with real validation checkpoints and error-recovery loops, and the closeout checklist guards against the mutation risks it flags upfront. The only weaknesses are minor repetition and setup/auth detail that could be moved to a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, imperative, and command-first with no explanations of concepts Claude already knows. Minor repetition (e.g. '--target-dir' guidance repeated across 'Target Checkout Modes', a few hedging sentences around diagnostics and the dist entrypoint) keeps it just below the lean anchor. | 4 / 5 |
Actionability | Commands are copy-paste ready throughout — from 'corepack enable' / 'pnpm install' to 'pnpm run review -- --local-only --item-number <pr-number>', per-shell auth login snippets, and the git clean-checkout sequence — and cover the common cases (issue vs PR, dirty checkout, auth failure, smoke run). The single implicit placeholder '<artifact-dir>' is inferable from 'artifacts/local-review-<pr-number>/'. | 5 / 5 |
Workflow Clarity | A clear sequence (locate, setup, run, read artifact, closeout) with explicit validation checkpoints ('git status --short' before use, clean-checkout guards, '--ff-only' pull) and error-recovery feedback loops (auth failure stops with the setup command; runtime failure reports the artifact path and stderr). The Closeout section acts as a final checklist, matching the top anchor. | 5 / 5 |
Progressive Disclosure | Well-organized single-file skill with clear sections and no nested or buried references. At ~190 lines with no reference split, first-time setup/auth detail (device auth, per-shell API-key handling, dist entrypoint notes) is inline material that could live in a one-level-deep reference file, so it fits 'good structure with minor organization gaps' rather than the fully split top anchor. | 4 / 5 |
Total | 18 / 20 Passed |