Content
70%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 a densely specified orchestration contract with an exemplary phase workflow — explicit exit criteria, measurable validation gates, and genuine error-recovery loops. Its weaknesses are redundancy across the four routing sections with duplicated summary blocks, and heavy dependence on ~15 referenced bundle files that are not present, leaving phase detail and the handoff template inaccessible.
Suggestions
Consolidate the overlapping routing sections (Trigger Guidance, Delegate Matrix, Output Routing, Collaboration) into a single routing section, and remove the CAPABILITIES_SUMMARY/COLLABORATION_PATTERNS comment block that duplicates them.
Ship or inline the critical referenced files — at minimum `reference/autorun-schema.md` (ONBOARDING/EXECUTE phase detail) and `_templates/handoff-bundle.template.json` — so the deferred procedural content and JSON Schema validation gate are actually reachable.
State the duplicated output-language rule once (in Core Contract or Output Requirements) instead of verbatim in both places.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The prose is telegraphic and assumes Claude's competence (no basic-concept explanations), but routing logic is restated across four sections (Trigger Guidance, Delegate Matrix, Recipes/Subcommand Dispatch, Output Routing), the language-output rule appears verbatim twice, and the CAPABILITIES_SUMMARY/COLLABORATION_PATTERNS comment block plus the Collaboration section duplicate each other nearly wholesale. This is 'mostly efficient but could be tightened' — not score 2 because every line carries orchestration rules, not padding, and not score 4 because the cross-section redundancy is more than minor. | 3 / 5 |
Actionability | Guidance is concrete throughout: exact paths (`.agents/design-system/{project}.json`), measurable gates ("WCAG 2.2 AA", "4.5:1 text, 3:1 UI", "fidelity ≥ 95%", "cap fan-out at 5 concurrent delegates"), worked examples per operation layer, and a delegate matrix keyed by artifact shape. It is not score 5 because key executable specifics are deferred to files not present in the bundle (`reference/autorun-schema.md` for ONBOARDING/EXECUTE phase detail, `_templates/handoff-bundle.template.json` for bundle validation), leaving the actual handoff-bundle format unspecified. Per the rubric's scoring notes, absence of code in an instruction-only skill is not penalized when guidance is actionable, which holds here. | 4 / 5 |
Workflow Clarity | The ONBOARDING → INTAKE → PLAN → EXECUTE → HANDOFF → DELIVER table gives each phase a goal, a key rule, and an explicit exit criterion, with validation gates baked in ("All bundles validate against `_templates/handoff-bundle.template.json` (JSON Schema)", "Validate WCAG 2.2 AA before DELIVER", "token-drift = 0, pixel fidelity ≥ 95%") and error-recovery loops (Ask First on ambiguity/oversized fan-out, escalation to Nexus, drift-triggered re-extraction). Batch fan-out operations do have validation, so the batch-operation cap does not apply. This matches the anchor for a clear sequence with explicit validation steps and feedback loops. | 5 / 5 |
Progressive Disclosure | The Reference Map is well-organized (file + "read this when" column, one level deep) and the body consistently defers detail to named files, but the bundle ships none of them — no `references/`, `scripts/`, or `assets/` directories exist, so the ~15 referenced paths (`_common/HANDOFF.md`, `_common/design-system-registry.md`, `reference/autorun-schema.md`, `_templates/handoff-bundle.template.json`, etc.) are unverifiable or dangling, and the skill's structure cannot actually function as written. This sits between 'references present but not clearly signaled' (they are clearly signaled) and 'good structure, references mostly clear' (they cannot be confirmed to exist), so 3 is the best fit. | 3 / 5 |
Total | 15 / 20 Passed |