Content
92%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.
A tightly written, highly actionable instruction skill: concrete gh commands throughout, an explicit six-step workflow with a pre-flight checklist and a no-network fallback, and clean one-level-deep delegation to wiki conventions and an examples file. The only weakness is mild redundancy between Step 5's rules and the faults table.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and repo-specific with no generic filler — it never explains what an issue or gh is, and constraints like 'the local shell is fish, which has no heredocs' are concrete and load-bearing. It falls just short of anchor 5 because 'The faults, by name' largely restates Step 5's rules (stock paragraph↔rule 1, empty section↔rule 2, want-not-problem↔rule 4, slash shorthand↔rule 7, done-when-cannot-fail↔rule 5, pointer-only↔rule 8), a minor redundancy that could be merged into the rules as inline examples. | 4 / 5 |
Actionability | Guidance is fully executable: copy-paste-ready commands with appropriate placeholders for the search ('gh issue list --repo <repository from the table> --state all --limit 20 --search ...'), label listing, both issue-create variants (public and tracker, with exact flag sets), and the full project-item workflow including the --jq filters. Concrete formats are given for titles and body lead-ins, and common cases (planned work, bug, epic, finding, needs:decision) each get specific instructions, with a worked example offloaded to references/examples.md. | 5 / 5 |
Workflow Clarity | Steps 1–6 are clearly sequenced (routing → duplicate search → title → type/labels → body → filing) with explicit validation: the Step 1 duplicate search across open and closed issues, the pre-flight checklist before running gh ('Right repository... no open duplicate', 'Every path and line in the body exists today', '**Done when** could fail'), post-filing steps, and an error-recovery fallback for 'No network, no gh' that forbids claiming an issue was filed. This matches the anchor-5 pattern of explicit validation, feedback loops, and checklists. | 5 / 5 |
Progressive Disclosure | The body is a clear overview that owns issue writing and explicitly delegates what it does not own ('Two things this skill does not own, and links to instead') to one-level-deep wiki paths, and to references/examples.md for worked examples — verified to exist and referenced once, clearly signaled ('references/examples.md has one'). Content is appropriately split and easy to navigate, matching anchor 5; no nested multi-level references exist. | 5 / 5 |
Total | 19 / 20 Passed |