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 highly actionable decision rubric with exact scoring anchors, a copy-paste output format, explicit tier thresholds, and strong validation gates and feedback loops. The main weakness is redundancy — several policies (tool-rejection handling, parent-tier inheritance, cheapest-model reflex) are restated across Capability and Effort, Rules, and Anti-Patterns — plus one dangling reference path inside the bundle.
Suggestions
State each policy once: the tool-rejection-vs-quota rule and the parent-tier-inheritance rule each appear in Capability and Effort, Rules, and Anti-Patterns — consolidate into a single authoritative section and cross-reference it from the others.
Trim the Anti-Patterns section to patterns not already covered near-verbatim in Rules, or merge Rules and Anti-Patterns into one checklist to remove roughly 10 lines of repeated content.
Resolve the dangling ARCHITECTURE.md reference in references/routing-table.md (line 120) — either add the file to the bundle or drop the pointer.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The tables and core sections are tight, but key policies are stated two to three times: tool-rejection-vs-quota appears in 'Capability and Effort' ('Tool argument rejections or unsupported parameters are schema errors, not provider exhaustion'), 'Rules' ('Do not treat tool parameter rejections as quota exhaustion'), and 'Anti-Patterns' ('tool rejections are not quota errors'); parent-tier inheritance is likewise repeated three times. Not 4: the redundancy exceeds minor instances; not 2: every sentence carries skill-specific policy and nothing explains concepts Claude already knows. | 3 / 5 |
Actionability | Fully executable for an instruction skill: exact 0/1/2 anchors per scoring dimension, a copy-paste output format ('SNC: S=[0-2] N=[0-2] C=[0-2] total=[n] tier=[low|medium|high]'), explicit tier thresholds (total 0-2 / 3-4 / 5-6), a routing table mapping each tier to concrete autonomy/verification/review/approval settings, and 'emit snc_tier and model_tier in every Handoff Payload'. Not 4: the common cases are covered without gaps. | 5 / 5 |
Workflow Clarity | The score → risk-floor → route → verify sequence is clear ('Score before planning'; 're-score after specialist-codebase-scout reports impact radius') with explicit validation gates ('HARD STOP before code, human approval before merge') and genuine feedback loops ('Re-score when scope grows mid-task; the tier must rise immediately'; 'Stop and re-score' on red-flag rationalizations; downward reassessment only with documented evidence). Not 4: validation checkpoints are explicit rather than implied. | 5 / 5 |
Progressive Disclosure | Both referenced files (references/snc-rubric.md, references/routing-table.md) exist, the anchored link '[Capability and effort resolution](references/routing-table.md#capability-and-effort-resolution)' resolves to a real header, and detail (worked examples, receipt fields) is appropriately split out with a closing References section. Not 5: references/routing-table.md points to ARCHITECTURE.md, which is not present in the bundle — a dangling second-level path; not 3: structure and signaling are otherwise good. | 4 / 5 |
Total | 17 / 20 Passed |