Content
93%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 instruction-only skill body: fully executable commands with zero concept padding, a distinct safe-workflow section with an explicit verification step, and clean single-file organization that needs no bundle references. The only gap is the absence of an error-recovery loop after verification, which keeps workflow clarity at 4 rather than 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and command-driven: every section is a copy-paste example or a non-obvious operational caveat (version check, --add-sub-issue move semantics, blocked-by/blocking duality). It explains nothing Claude already knows — anchor 5 ('lean and efficient; every token earns its place'). Not anchor 4 because there are no sections that could be trimmed without losing real information. | 5 / 5 |
Actionability | Every instruction is an executable, copy-paste-ready gh command with concrete issue numbers, covering create/edit/add/remove for all four relationship types plus human-readable, grep-able, and JSON inspection modes. This matches anchor 5 ('fully executable; copy-paste ready; specific examples cover the common cases') and exceeds anchor 4, which tolerates minor gaps — the version-capability preflight check even guards executability. | 5 / 5 |
Workflow Clarity | The 'Safe workflow' section gives a clear 4-step sequence including an explicit verification step ('Verify with gh issue view ... --json parent,subIssues,...'), satisfying the batch-operation validation requirement that would otherwise cap the score at 3. It falls short of anchor 5 because there is no feedback loop — no instruction for what to do when verification shows the link is wrong or the command fails. | 4 / 5 |
Progressive Disclosure | This is a single-purpose skill with no bundle files (references/, scripts/, assets/ are absent) and no content that warrants external files; the ~147-line body is a well-organized reference with clearly headed sections (reference format, parent/sub-issues, blocked-by/blocking, inspection, safe workflow). Per the simple-skill guidance, well-organized sections with no need for external references score 5; navigation is trivial and nothing is buried. | 5 / 5 |
Total | 19 / 20 Passed |