Content
85%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 lean, well-structured instruction-only skill: a clearly sequenced workflow with real validation checkpoints, an escalation feedback loop for label permissions, and a final checklist. The only minor gaps are a few unexpanded gh command invocations and light redundancy between the new-issue and edit-issue content rules.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, imperative, and free of padding — it never explains what GitHub or issues are, and every bullet states a skill-specific rule Claude could not infer. It sits at anchor 4 rather than 5 only because of minor repetition (the visible-summary/`<details>` rules are restated across the new-issue, edit-issue, and Quick Checks sections) and a few wordy phrasings that could be tightened. | 4 / 5 |
Actionability | Concrete guidance throughout: exact paths (`.github/ISSUE_TEMPLATE/`), commands (`gh issue create`, `gh issue edit`, `/label <label name>`, `Suggested labels: ...`), concrete label names (`severity/major`, `severity/moderate`, `component/*`), and a concrete mechanism (`<details>` blocks). Anchor 5 is missed by minor gaps — no complete example invocations with flags (e.g. `gh issue edit --title ... --body-file ...`) and the duplicate-search step names no search command. | 4 / 5 |
Workflow Clarity | The workflow has a clear numbered sequence (write → search → template → patch → label → file-based edits) with explicit validation checkpoints ("diff the patched body against the current issue body before calling gh", review against the template before calling gh), a genuine feedback loop for error recovery (label permissions missing → `/label` comment → `Suggested labels: ...` fallback), and a closing Quick Checks checklist — matching anchor 5's sequence + validation + feedback loop + checklist pattern. | 5 / 5 |
Progressive Disclosure | There are no bundle files (references/, scripts/, assets/ are absent), and the ~50-line body needs none: it is cleanly organized into Overview, Workflow, and Quick Checks sections with no content that belongs in a separate file. Per the rubric's scoring note for short, single-purpose skills with no external references, this warrants a 5. | 5 / 5 |
Total | 18 / 20 Passed |