Content
92%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 excellent operational skill: fully executable gh-based guidance with a clearly sequenced workflow, explicit pre-publish and post-edit validation for the risky full-issue-body rewrite, and error-recovery paths for reruns. The only nit is minor repetition of the table sort and formatting rules, which slightly inflates token cost without adding clarity.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and command-dense with no explanations of concepts Claude already knows, but there is minor repetition that could be trimmed: the descending-count sort rule is stated three times (Goal step 2, the insert guidance, and the pre-publish check) and the five-cell/blank-line rules each appear twice. This fits the score-4 anchor of efficient content with minor instances that could be trimmed, rather than score 5 where every token appears exactly once and earns its place. | 4 / 5 |
Actionability | Every step is backed by copy-paste-ready gh commands with exact flags and JSON field lists, covering all input scenarios (PR given, run/job URL given, no context), tracker updates via --body-file, verification, and three rerun variants. This matches the score-5 anchor of fully executable guidance whose examples cover the common cases, not score 4, since there are no missing key details. | 5 / 5 |
Workflow Clarity | The workflow is clearly sequenced (find failure, classify, build signature, update tracker, rerun, report) with explicit validation checkpoints for the destructive full-body issue edit: a pre-publish checklist (rows retained, five cells, sorted counts, no blank lines), a post-edit re-fetch and comparison, and rendered-layout verification. Error recovery is also handled ("If gh run watch exits non-zero because cancellation made the run fail, continue to rerun failed jobs"), matching the score-5 anchor with its feedback loops and checklists. | 5 / 5 |
Progressive Disclosure | No bundle files exist and none are needed: this is a single cohesive operational workflow (~157 lines) that would not benefit from being split across references, and it is organized under clear, navigable section headers. It fits the score-5 spirit of content appropriately placed with easy navigation; score 4 would apply if content that belongs in separate files were inlined or organization had gaps, which is not the case. | 5 / 5 |
Total | 19 / 20 Passed |