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.
The body is an operationally dense, well-sequenced guide: executable gh/glab/git commands for both GitHub and GitLab, approval-gated writes, and a bundled CI watcher with explicit merge gates and re-validation after head changes. Its only weakness is mild verbosity in the account-selection prose and the watcher's status semantics.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious operational rules ("A TLS timeout, connection reset, rate limit, or GitHub server error is not evidence of logout") and never explains basics Claude already knows, but a few passages could be tightened — e.g. the repeated identity caveats in "Choose the account deliberately" and the multi-sentence behavioral spec of the watcher. Efficient with minor trim opportunities: anchor 4, not the every-token-earns-its-place of anchor 5. | 4 / 5 |
Actionability | Commands are copy-paste ready with standard placeholders and cover the common cases for both platforms: "gh repo view OWNER/REPO --json name,description,url,defaultBranchRef", "gh pr create --repo OWNER/REPO --title \"...\" --body-file pr.md", "glab mr create --repo GROUP/PROJECT --title \"...\" --description-file mr.md", "node \"<skill dir>/scripts/watch-ci.mjs\" --repo OWNER/REPO --pr NUMBER --head REVIEWED_HEAD_SHA", and "gh pr merge NUMBER --repo OWNER/REPO --squash --match-head-commit REVIEWED_HEAD_SHA". Fully executable guidance matching the anchor-5 example standard. | 5 / 5 |
Workflow Clarity | Sections follow the real lifecycle — choose account, login only on confirmed rejection, read-only inspection, checkout/edits, approval-gated writes, CI wait, head-guarded merge — with explicit validation checkpoints ("Run the repo's tests", "Capture the full head SHA... before review", "Re-read checks and review threads immediately before merging") and feedback loops ("After any push or head change, discard old success/review evidence and repeat"). Destructive writes are gated by approval and the atomic --match-head-commit guard, so the missing-validation cap does not apply. | 5 / 5 |
Progressive Disclosure | The single bundle file (scripts/watch-ci.mjs, verified to exist and be substantive) is referenced one level deep with its full invocation and rationale ("Use the bundled helper instead of a bare gh pr checks --watch"), and the polling/retry internals are correctly delegated to the script rather than inlined. Six clearly headed sections make the ~137-line body easy to navigate, with no nested or buried references. | 5 / 5 |
Total | 19 / 20 Passed |