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.
An exemplary operational skill: dense, zero-padding prose carrying only non-inferable project knowledge, fully executable commands, an explicitly sequenced workflow with systematic validation checkpoints, and clean internal structure. The only structural improvement is moving the shared §Claim protocol (and possibly the API-budget notes) into a one-level-deep reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every sentence carries operational field knowledge Claude could not infer — the GraphQL point budget, 'gh project item-list … truncates at --limit without a warning', 'Do not trust gh api rate_limit' — with zero padding and no explanation of known concepts (gh, jq, GraphQL basics). Not 4: there is no identifiable over-explanation to trim; even the 'Common mistakes' table states non-obvious project rules rather than restating the obvious. | 5 / 5 |
Actionability | Fully executable: copy-paste `gh api`/`jq` commands with real endpoints and field ids (only `<Status field id>`, `<repo>`, `<n>` as parameters), a worked blackboard-block example in the target output format, and a decision table mapping every Up Next condition to a row. Not 4: the commands plus the concrete output template cover the common cases end to end with no gaps. | 5 / 5 |
Workflow Clarity | Steps 1–6 plus the Claim protocol are explicitly sequenced with validation checkpoints throughout: 'Every Up Next item appears under Batch, Queue, Skipped or Questions. One that appears nowhere was not read', 'Read the file before writing to it', live/stale checks, 'Nothing runs between the check and the write', and error-recovery loops ('An open blocker sends the task back to the Queue'; a rate-limit error is 'Unknown: wait, then check again', never 'not claimed'). Not 4: the batch operation has explicit validation and feedback loops, so the batch-operation cap does not apply and checkpoints are not merely 'most' but systematic. | 5 / 5 |
Progressive Disclosure | Well-organized single-file structure with clear section headers, a decision table, and a mistakes table; no bundle files exist and none is strictly needed. Not 5: at ~150 dense lines, material shared with other skills — the §Claim protocol that 'orchestrate' and 'new-feat' also run — and the API-budget appendix are candidates for a one-level-deep reference file, which would keep the overview leaner. | 4 / 5 |
Total | 19 / 20 Passed |