Content
100%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 single-purpose skill body: executable commands, an acceptance table, result handling, and a verification section with feedback loops for an irreversible publish operation. It is concise, well-structured, and needs no external references.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean throughout: assumes Claude knows what gh/PRs are and spends tokens only on non-obvious gh-specific behavior (alt-text `#` quoting, path-pairing rules, untrusted-body handling). The `gh 2.99` version note is a genuine requirement rather than padding. | 5 / 5 |
Actionability | Every section gives copy-paste-ready `gh` commands covering the common cases (comment, description edit, create, in-body placement, verify), with exact flags and absolute-path conventions. | 5 / 5 |
Workflow Clarity | Sequences a publish-and-no-undo operation with an upfront acceptance table, a result-decision table, and an explicit Verify section with count checks and feedback loops (re-attach missing files, rewrite a misplaced reference rather than re-uploading). | 5 / 5 |
Progressive Disclosure | No bundle files are needed; the body is self-contained and organized under clear section headers (What it accepts, Attaching, Read the result, Verify, Sizing), giving easy navigation with no nested references. | 5 / 5 |
Total | 20 / 20 Passed |