Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a highly actionable, well-sequenced workflow with strong validation feedback loops and concrete commands throughout. Its main weaknesses are length/redundancy (gates restated across sections) and a monolithic structure with no reference files, despite sections large enough to warrant progressive disclosure.
Suggestions
Deduplicate the autoreview, docs-creator, and security-advisory gate descriptions that recur across Intake, Review And Risk Gates, and Verification — state each gate once and reference it.
Move the long 'Security Advisory Hotfixes' and 'Task-Style PR Body' procedures into reference files (e.g. references/security-advisory.md, references/pr-body.md) and link to them from the body to improve progressive disclosure.
Tighten the 'Skill Diet' list and repeated skill-loading guidance, which overlap with the Intake classification steps, to reduce token cost.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and rule-driven with no basic-concept fluff, but at ~480 lines it repeats the same gates (autoreview, docs-creator, security-advisory) across Intake, Review And Risk Gates, and Verification, so it could be tightened; matches anchor 2 rather than the 'every token earns its place' bar of anchor 3. | 2 / 3 |
Actionability | Pervasive concrete executable commands ('gh issue view', 'gh api repos/<owner>/<repo>/security-advisories/<GHSA_ID>', 'npx skills remove <skill> -y', 'pnpm run reinstall', 'npm view <package>@<version>', 'gh pr view --json body') plus an exact emoji/table PR-body format make it copy-paste ready, matching anchor 3. | 3 / 3 |
Workflow Clarity | Multi-step processes are clearly sequenced (numbered Intake 1-14, per-type Execution Paths) with explicit validation checkpoints and feedback loops (reinstall-then-rerun on local-corruption signals, autoreview retried until no accepted findings) plus a Success Criteria checklist, matching anchor 3. | 3 / 3 |
Progressive Disclosure | No bundle files exist and the skill is a well-sectioned but monolithic ~480-line document; large blocks like 'Security Advisory Hotfixes' and 'Task-Style PR Body' could be split into reference files, so it matches anchor 2 rather than a cleanly split overview with one-level-deep references. | 2 / 3 |
Total | 10 / 12 Passed |