Content
73%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 an exceptionally well-sequenced orchestration policy: topology diagram, per-mode wave routing, schema validation with bounded retry loops, a mandatory mechanical linter, and a single-writer output contract, with every referenced bundle asset real and one level deep. Its weaknesses are structural repetition (each core rule restated 3-5 times) and two unresolved references (inconsistent persona paths, an undefined safe-outputs interface), which hold conciseness and actionability below the top anchors.
Suggestions
State each core rule (advisory regime, single-writer interlock, ASCII-only, no-vendor-foundation ban) once in 'Architecture invariants' and cross-reference it from the wave sections, output contract, and gotchas instead of restating it verbatim 3-5 times.
Resolve the persona-path inconsistency: the roster table links ../../../.apm/agents/spec-*.agent.md while Wave 3 instructs subagents to load ../../agents/spec-<slug>.agent.md -- pick one canonical relative path.
Define or link the safe-outputs interface (add-comment max: 1, remove-labels) so the Wave 6 sweep and single-emission interlock are executable without external repo knowledge.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body explains no concepts Claude already knows and is dense with skill-specific policy, but core rules are restated many times: 'advisory, not gate regime', the single-writer interlock, ASCII-only, and the no-vendor-foundation ban each appear 3-5 times across 'Architecture invariants', the wave sections, the 'Output contract', and 'Gotchas' (e.g. 'NEVER render the words Verdict, APPROVE, REJECT' appears in both Wave 6 and the output contract, and again inside assets/comment-template.md). Mostly efficient but could be tightened to one canonical statement plus cross-references, which matches anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') better than anchor 4's 'minor instances'. | 3 / 5 |
Actionability | Wave 0 gives exact thresholds ('diff added < 50 lines AND removed < 50 lines', 'no anchor of the form `<a id="req-`', the literal marker 'apm-spec-guardian: new-version'), Waves 3-4 enumerate prompt fields and verbatim decision rules ('If sum(panelist.new_blocking_findings) > 0 ... MUST be next_brief', 'shocked_meter_avg < 7.0 -> needs_revision'), and Waves 5-6 map to real, verified bundle assets. Minor gaps keep it below anchor 5: the roster table cites personas at '../../../.apm/agents/spec-*.agent.md' while Wave 3 instructs '../../agents/spec-<slug>.agent.md' (two different paths for the same files), and the 'safe-outputs.remove-labels' interface invoked in Wave 6 is not defined anywhere in the bundle. | 4 / 5 |
Workflow Clarity | The topology diagram plus numbered waves (0, 3, 4, 5, 6) with explicit per-mode skip rules give a fully clear sequence, and every stage has a validation checkpoint with a feedback loop: 'S4 schema-validate per return ... on malformed: re-spawn that panelist (max 2 attempts; then placeholder)', re-spawn the synthesizer 'once with the violation cited', a mandatory 11-check linter before render (verified: assets/linter-checklist.md contains exactly 11 checks), and a loop budget with exhaustion semantics ('the maintainer should ESCALATE'). This matches anchor 5's 'explicit validation steps; feedback loops for error recovery; checklists'. | 5 / 5 |
Progressive Disclosure | All four referenced assets (panelist-return-schema.json, synthesizer-return-schema.json, linter-checklist.md, comment-template.md) exist and are one level deep, and the bulky material is correctly split out of SKILL.md, which itself stays an orchestration overview. It is not anchor 5 because the persona agent files live outside the bundle at two inconsistent paths ('../../../.apm/agents/...' in the roster vs '../../agents/...' in Wave 3), making navigation to them ambiguous, and some inlined wave/gotcha prose could live in assets -- 'good structure; most content is appropriately placed; minor organization gaps' (anchor 4). | 4 / 5 |
Total | 16 / 20 Passed |