Content
51%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 body is a two-line delegation stub: maximally lean, but it carries none of the skill's actual guidance — every command, workflow step, and validation checkpoint is deferred to a shared skill file outside the bundle that cannot be verified here. As written it is a clear pointer, not a self-contained, actionable skill.
Suggestions
Inline a minimal quick-start with the core commands (e.g., `gh pr checks <PR-number>`, `gh run list --branch <branch>`, `gh run view <run-id> --log-failed`) so the skill remains actionable even when the shared skill file is unavailable.
Sketch the workflow in the body — check status, summarize failures, optionally re-run (`gh run rerun <run-id> --failed`), then verify the re-run succeeded — so the sequence and its validation step are visible without loading the external file.
Reference the shared skill via a bundle-relative path (or vendor it under references/) instead of the absolute `~/.agents/skills/gha-checks/SKILL.md`, so the delegation target resolves from the skill bundle itself.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The entire body is "Load and follow the shared skill at `~/.agents/skills/gha-checks/SKILL.md`" plus a one-line provenance comment — no padding and no explanation of concepts Claude already knows; every token earns its place, matching the level-5 anchor. | 5 / 5 |
Actionability | The only instruction is "Load and follow the shared skill at ..." — concrete as a directive, but it defers every step of the actual task and contains no command or code for checking CI status, matching level 2 ("minimal concrete guidance; missing the specific steps to execute"). It is above level 1 because the pointer itself is specific and instructive rather than vague. | 2 / 5 |
Workflow Clarity | No sequence for the actual task (check status, summarize failures, re-run jobs) appears in the body; the single delegation step is unambiguous, but all task steps and any validation (e.g., confirming a re-run succeeded) are pushed into an external file — fitting level 2 ("steps poorly defined; validation absent") rather than level 1, since the one written instruction is coherent. | 2 / 5 |
Progressive Disclosure | The reference is one level deep and clearly signaled, but the body contains no overview content at all, and the target `~/.agents/skills/gha-checks/SKILL.md` lies outside the bundle (no references/, scripts/, or assets/ exist, and the absolute path does not resolve in this environment) — "could be better organized" fits level 3; not level 4, because no content is appropriately placed within this skill and the reference cannot be verified from the bundle. | 3 / 5 |
Total | 12 / 20 Passed |