Content
96%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 interactive-setup skill body: lean, decision-complete, with concrete commands, exact defaults, a copy-ready template, and a confirm-before-write checkpoint. The single weakness is that the five referenced seed-template files are not present in the skill bundle as evaluated, leaving the Write step's starting points unverifiable.
Suggestions
Ship the five seed templates (issue-tracker-github.md, issue-tracker-gitlab.md, issue-tracker-local.md, triage-labels.md, domain.md) alongside SKILL.md — the Write step depends on them, and the links currently resolve to missing files in this bundle.
Move the seed templates under a references/ subfolder (e.g., references/issue-tracker-github.md) and update the links, matching the conventional bundle layout and making the skill folder easier to scan.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, imperative instruction with zero concept explanation ('Lead each section with the recommended answer so the user can accept it in a word', 'Never create AGENTS.md when CLAUDE.md already exists'). Every line is a decision rule or a concrete check; conditional branches are stated only where they branch. Matches anchor 5 — assumes Claude's competence and every token earns its place; anchor 4 would require trimmable over-explanation, of which only the user-facing Section A explainer (justified as copy shown to the user) comes close. | 5 / 5 |
Actionability | Concrete throughout: exact commands ('git remote -v'), exact paths ('docs/agents/issue-tracker.md', '.scratch/<feature>/'), exact label strings ('needs-triage', 'ready-for-agent', ...), an explicit file-selection decision tree ('If CLAUDE.md exists, edit it. Else if AGENTS.md exists, edit it'), and a copy-ready markdown template for the '## Agent skills' block. For an instruction-only skill this is fully executable guidance — anchor 5; not anchor 4, which expects minor gaps, and the placeholders ('[one-line summary of where issues are tracked]') are correctly generative rather than pseudocode. | 5 / 5 |
Workflow Clarity | A clear five-phase sequence (Explore → Present findings and ask → Confirm and edit → Write → Done) with an explicit validation checkpoint: 'Show the user a draft... Let them edit before writing' before any file is touched, plus in-place-update and don't-overwrite rules as error-avoidance loops. The operation is interactive and non-destructive, so the destructive/batch cap does not apply; anchor 5's explicit checkpoints and feedback loops are present, while anchor 4 would require missing validation. | 5 / 5 |
Progressive Disclosure | Good structure: five numbered sections, a clear overview, and five one-level-deep, well-signaled template references each with a one-line purpose ('[issue-tracker-github.md](./issue-tracker-github.md) — GitHub issue tracker'). It falls short of anchor 5 because the referenced seed templates do not exist alongside SKILL.md in this copy — the links cannot be verified as real files — and the templates sit at the skill root rather than under references/, which is a minor organization gap; it is clearly above anchor 3's inlined-content problem since nothing bulky is inlined. | 4 / 5 |
Total | 19 / 20 Passed |