Content
88%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 procedural skill: copy-paste-ready commands, an explicit idempotency guard against double posting, and clear termination conditions. The only trims available are small redundancies between sections; no significant reorganization is needed.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence — no explanation of gh, git, or CI concepts — but contains minor repetition that could be trimmed: "Never add any label to it" is restated in the Never section, and the one-plan-per-week rule appears both in its own section and in Never. This matches 'efficient; minor instances of over-explanation' rather than the every-token-earns-its-place anchor 5. | 4 / 5 |
Actionability | Fully executable throughout: exact gh commands with complete --json field lists, a GraphQL query for pinned issues, a jq comment check, a literal comment template, and a deterministic field-to-status mapping (isDraft, statusCheckRollup conclusions, reviewDecision values). Nothing is pseudocode or vague. | 5 / 5 |
Workflow Clarity | The sequence (read → find/create plan issue → check for this week's marker → post → stop) is explicit, with real validation checkpoints: the week-marker idempotency check before posting, truncation disclosure when a list hits its limit, fallback branches for zero or duplicate plan issues, and a defined stop condition covering gh failure. These are explicit validation steps with error handling, matching anchor 5. | 5 / 5 |
Progressive Disclosure | Sections are well-organized with clear headers and no orphaned references (no bundle files exist, and the body references none), so navigation is easy. However, at roughly 105 lines — above the under-50-line simple-skill exception — inline material like the comment template and status-mapping rules could arguably live in a reference file, matching 'good structure; minor organization gaps' rather than anchor 5. | 4 / 5 |
Total | 18 / 20 Passed |