Content
85%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.
The content is a tight, well-structured operational guide with executable commands and a clear validation-rich feedback loop. Minor trimming of the repeated check command and a note on non-GHA diagnosis would push it to full marks.
Suggestions
Replace the verbatim repeat in Guardrails with a short reference (e.g. "Re-run `gh pr checks --json ...` after every push") to remove the duplicated token cost.
Add a brief pointer for diagnosing failures from non-GitHub-Actions checks (e.g. following the check's `link`), since the only diagnosis command targets GHA runs.
Consider noting where to find required-checks vs informational-checks (e.g. `gh pr checks --json name,bucket` plus required status context) so the "until green" target is unambiguous.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence with no concept over-explanation, but the full command "gh pr checks --json name,bucket,state,workflow,link" is repeated verbatim in both Commands and Guardrails and could be trimmed. | 4 / 5 |
Actionability | The Commands section provides concrete, executable gh commands with real flags and the workflow maps to them, but diagnosis guidance only covers GitHub Actions logs (gh run view --log-failed), leaving a minor gap for non-GHA failing checks. | 4 / 5 |
Workflow Clarity | The 5-step workflow has a clear sequence with explicit validation checkpoints (inspect before waiting, re-check after every push) and a feedback loop (repeat until green, retry flaky once), matching the anchor for explicit validation and error-recovery loops. | 5 / 5 |
Progressive Disclosure | This is a simple, under-50-line skill with no need for external references, and it is organized into well-signaled sections (Trigger, Workflow, Commands, Guardrails, Output), which per the guidelines earns a 5. | 5 / 5 |
Total | 18 / 20 Passed |