Content
81%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.
A dense, high-quality orchestration skill: every phase has concrete commands, explicit outputs, validation gates, and a complete failure-mode ledger. The main costs are redundancy from restating the hard invariants in multiple sections and inconsistent flag delimiter syntax that undercuts copy-paste executability.
Suggestions
State each hard invariant (never-overwrite, bib-frozen, whitelist-binding) once in Constants and reference it elsewhere instead of restating it in Why This Exists, Phase 0, Key Rules, and Notes.
Standardize flag syntax: pick one delimiter ('--' or '—') and one spelling per flag — the same flag currently appears as both '--soft-only' and '— soft-only', and bash blocks mix both styles, which breaks copy-paste execution.
Move the page-shrink heuristic steps and the failure-mode/reason-code table into a references/ file linked from the pipeline section to shorten the SKILL.md body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is almost entirely load-bearing operational content (bash snippets, YAML whitelists, verdict tables, exact regexes) with no explanations of concepts Claude already knows. However, the core invariants ('never overwrite prior submission directories', 'bib is frozen') are restated across Why This Exists, Constants, Phase 0, Key Rules, and Notes, and the Notes section re-explains the page-shrink order already given in its own section — more than strictly necessary. | 4 / 5 |
Actionability | Mostly copy-paste-ready: Phase 0/0.5/4 bash blocks, the edit_whitelist.yaml, the KNOWN_WEAKNESSES schema, and per-round diff/snapshot commands are concrete and executable. It is not a 5 because flag syntax is inconsistent — the same flag appears as both '--soft-only' and '— soft-only', and bash blocks mix '--' and em-dash '—' delimiters ('— effort: "$EFFORT"'), which breaks copy-paste execution as written; the Phase 1 atomization and Phase 3 triage blocks are orchestration pseudocode rather than runnable commands. | 4 / 5 |
Workflow Clarity | Phases 0→4 are clearly sequenced with each phase's output artifacts explicitly stated ('Output of Phase 0: a new sibling dir...'), explicit validation checkpoints (compile + page count, 5-layer anonymity scan, per-round diff gate with whitelist compliance check, final claim audit, forensics gate), convergence criteria, and a full failure-mode table with reason codes and recovery paths. The destructive-operation risk (overwriting prior submissions) is guarded by an atomic mkdir that fails fast. | 5 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent), and the cross-skill references ('../shared-references/reviewer-backends.md', '../shared-references/assurance-contract.md', '../integrity-forensics/SKILL.md') are clearly signaled one level deep with markdown links. Section headers make the ~460-line body navigable, but content like the page-shrink heuristic details and the failure-mode table are inlined in a single file that could be split into reference files. | 4 / 5 |
Total | 17 / 20 Passed |