Content
57%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.
The body is highly actionable and well-phased, but it suffers from repeated policy restatements, an unreferenced bundle fetcher script with duplicated inline logic, and missing validation checkpoints for a batch operation. Structure exists but content that should live in separate files is inlined.
Suggestions
Reference scripts/gh_fetch.py for fetching/pagination instead of inlining ~40 lines of bash, so the bundle file is actually used and SKILL.md stays lean.
Dedupe the zero-action policy to a single authoritative section and have subagent prompts point back to it rather than restating forbidden commands and footers repeatedly.
Add an explicit validation checkpoint in Phase 4 (verify each report file exists, contains at least one permalink, and that no gh mutation command was issued) before marking a task completed.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly concrete with no basic-concept padding, but the zero-action policy is restated 4+ times (role, <zero_action>, ABSOLUTE RULES, Common Preamble, and each PR prompt's footer) and the forbidden-commands list is duplicated, so it could be tightened substantially. | 3 / 5 |
Actionability | Provides copy-paste-ready bash for fetching/pagination and complete per-type report templates, plus concrete gh commands; minor gaps come from the pseudocode task_create/task/background_output API that isn't a real tool signature. | 4 / 5 |
Workflow Clarity | A clear Phase 0–5 sequence exists, but this is a batch operation (spawn one task per item, process ALL items) and Phase 4 lacks validation that reports were written, contain evidence, or that no GitHub mutation occurred — the batch-operation cap of 3 applies. | 3 / 5 |
Progressive Disclosure | Section structure is present, but the bundle file scripts/gh_fetch.py is never referenced while ~40 lines of pagination bash are inlined instead, and ~300 lines of per-type subagent prompt templates that belong in reference files are all inlined in SKILL.md. | 3 / 5 |
Total | 13 / 20 Passed |