Content
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The SKILL.md body is a lean, action-oriented overview that gives exact commands and guardrails while deferring stage detail to real, one-level-deep reference files. It includes explicit pre-flight validation checkpoints and duplicate-guard idempotency logic, scoring at the top of every dimension.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with operational content (exact gh JSON fields, --body-file vs --body distinction, guardrails) and assumes Claude's competence without explaining basic PR/Git concepts; it exceeds level 2 because there is no conceptual padding, only a couple of long enrichments/cross-reference lines. | 3 / 3 |
Actionability | Provides copy-paste-ready executable commands — 'gh issue view "$NUM" --repo "$REPO" --json ...', 'enter_worktree(name: "triage")', 'exit_worktree(action: "remove")', the env-resolution chain, and the exact comment marker — matching the level-3 anchor for fully executable guidance. | 3 / 3 |
Workflow Clarity | Clear sequence (Resolve -> Fetch -> Rules -> Duplicate Guard -> Format -> Pre-flight -> Workflow) with explicit validation checkpoints — the 'DO NOT SKIP' pre-flight checks, testing-evidence rules, and duplicate-guard exit-vs-rerun branching provide the feedback loops the level-3 anchor rewards; level 2's missing-checkpoint gap does not apply. | 3 / 3 |
Progressive Disclosure | Body is a well-signaled overview that delegates detail to two verified, one-level-deep reference files ('Issue -> read references/issue-workflow.md', 'PR -> read references/pr-workflow.md'), both of which exist; content is appropriately split with easy navigation, matching the level-3 anchor. | 3 / 3 |
Total | 12 / 12 Passed |