Content
56%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 exceptionally concrete, validation-heavy orchestration workflow whose execution guidance is strong, but it is significantly overlong for a SKILL.md body. The duplicated reviewer prompt, five restatements of the same bias-guard invariant, and a fully inlined whitelist specification inflate token cost, and the absent bundle means none of it is progressively disclosed.
Suggestions
Replace the Step 5 review prompt with a reference to the Step 2 prompt plus only the Round-2 deltas (fresh zero-context instruction and the 'ignore any prior review rounds' lines), saving ~40 duplicated lines.
Move the edit-whitelist specification (schema, resolution rules, glob semantics, forbidden-operation detectors, round behaviors) into a references/edit-whitelist.md and keep a short summary with the abort-on-load-failure rule plus a link in SKILL.md.
Fix the sequencing defects: deduplicate the two 'Step 9' headings, place Step 5b after Step 5.5 (or renumber), and implement the actual comparison loop in the Step 4.5 heredoc instead of the '# Compare normalized theorem blocks...' comment placeholder.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The Step 2 and Step 5 reviewer prompts are ~45 lines of near-verbatim duplication, the reviewer-independence invariant is restated five times (header blockquote, Constants, dedicated protocol section, Step 5, Key Rules), and the ~100-line edit-whitelist spec is fully inlined. Not 1 because nothing explains concepts Claude already knows — the padding is skill-specific operational detail, but it is clearly padded rather than 'some tightening'. | 2 / 5 |
Actionability | Gives exact bash commands, MCP invocation configs (model + reasoning effort), complete reviewer prompts, regex detectors for forbidden operations, and YAML/JSON schemas — mostly copy-paste ready. Not 5 because the Step 4.5 heredoc defines normalize() but leaves the actual main-vs-appendix comparison as a comment placeholder, and several steps ('Parse user response same as /auto-review-loop', reviewer-slot resolution) defer to material not present in the skill. | 4 / 5 |
Workflow Clarity | Steps 0–9 are clearly sequenced with explicit validation checkpoints (0 undefined refs after recompile, restatement regression test, format-check stop criteria with location-aware hard blocks, whitelist rejection logging, NOT_APPLICABLE/BLOCKED fallbacks for kill-argument). Not 5 because there are two duplicate 'Step 9' headings (Document Results and Summary) and Step 5.5 is ordered before Step 5b, which muddies the sequence despite validation being thorough. | 4 / 5 |
Progressive Disclosure | Section headers are clear and external references (../shared-references/*.md, tools/extract_paper_style.py, skills/kill-argument) are one level deep and clearly signaled, but no bundle files exist and every referenced helper lives outside the skill where it cannot be resolved from it, while ~100 lines of whitelist parameter documentation and two full review prompts are inlined that clearly belong in separate reference files. Not 4 because the amount of inlineable content in a 700-line body outweighs the good signaling. | 3 / 5 |
Total | 13 / 20 Passed |