Content
96%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.
Excellent operational content: terse, concrete, and fully executable, with three workflows that each define a completion check and failure-recovery path. The only structural gap is that all detail is inlined in SKILL.md with no one-level-deep reference files for bulkier material such as the GraphQL queries and CI gotchas.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and imperative with zero padding — e.g. 'The REST API returns review comments without saying which are resolved. GraphQL says.' and 'Start at the first error, not the last line.' It explains nothing Claude already knows (no 'what a PR is', no library intros); every token carries operational information the model could not infer. Matches the lean anchor 5. | 5 / 5 |
Actionability | Commands are copy-paste ready and cover the common cases: a complete GraphQL query for listing review threads, 'gh pr view 42 --json mergeStateStatus' with per-status meanings, 'gh api repos/{owner}/{repo}/pulls/42/comments/<databaseId>/replies -f body=...', and gh stack commands with exit-code handling ('Exit code 3 is a rebase conflict: resolve it, git add, then gh stack rebase --continue, or --abort'). Fully executable guidance matches anchor 5. | 5 / 5 |
Workflow Clarity | Each of the three workflows is a numbered sequence with explicit completion checks and error-recovery loops: 'Done when step 1 shows every thread you fixed as resolved', 'Done when gh pr checks 42 passes on the new head commit', rerun-once feedback ('A second failure is real'), and exit codes 3 and 9 recovery for stacks. Clear sequences with validation checkpoints and feedback loops match anchor 5. | 5 / 5 |
Progressive Disclosure | Sections are well organized (MCP server, Gotchas, Review threads, Failing checks, Stacked PRs) with an explicit pointer to the git-workflow skill and GitHub docs. However there are no bundle files at all: the full GraphQL query and the workflow-token/paths-filter gotchas are inline detail that could live in one-level-deep reference files, and the body exceeds 50 lines so the simple-skill exception does not apply. Good structure with minor organization gaps matches anchor 4 rather than the appropriately-split anchor 5. | 4 / 5 |
Total | 19 / 20 Passed |