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 short-form skill body: concise, fully actionable, with a clear looped workflow and explicit validation/feedback checkpoints for a destructive merge operation. Organization is clean and references are one level deep.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and efficient throughout — executable `gh` commands with no padding, no explanation of concepts Claude already knows, and every line earns its place. | 5 / 5 |
Actionability | Fully executable, copy-paste-ready `gh pr view`, `gh pr checks`, `gh pr merge`, and `gh run view` commands cover the common cases; only the inherent `<run-id>` placeholder requires substitution. | 5 / 5 |
Workflow Clarity | A clearly sequenced loop with explicit restart-after-each-change semantics, validation checkpoints (draft/blocker detection, checks-watch, inspect-failed-logs-before-acting), and feedback loops (fix→push→restart, flake→rerun→restart) for the destructive merge operation. | 5 / 5 |
Progressive Disclosure | A compact, single-purpose skill (~55 lines) with well-organized sections (Loop, CI Failures) and one-level-deep, clearly signaled cross-skill links to pr-ready and flake; no bundle files needed. | 5 / 5 |
Total | 20 / 20 Passed |