Content
85%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 highly actionable with strong, validated workflows and a clean reference index, but progressive disclosure is undermined by four dangling references — two of them (house-style.md, visual-styles.md) load-bearing to the stated Visual Identity Gate — and there is some length in the OpenDesign render section that could be tightened.
Suggestions
Create the missing referenced files (house-style.md, visual-styles.md, patterns.md, data-in-motion.md) or remove the links — house-style.md and visual-styles.md are cited as the default-motion and 8-preset authorities the Visual Identity Gate depends on, so their absence breaks the gate the skill instructs Claude to follow.
Tighten the OpenDesign render workflow: keep the fast-path summary inline and move the full dispatch wait-loop (or its verbose inline comments) into a script under ./scripts/ or a reference file to reduce token load.
Flatten the transitions routing (SKILL.md → transitions.md → transitions/catalog.md is 2 levels deep) by merging catalog.md into transitions.md or linking the per-type files directly from the SKILL.md reference list.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with actionable rules, tables, and complete code rather than concept padding, but the OpenDesign render workflow carries a long bash loop with verbose inline comments and rationale ('Why this matters:', repeated sandbox-exec/daemon explanations) that could be trimmed — efficient with minor over-explanation, not the lean 'every token earns its place' anchor. | 4 / 5 |
Actionability | Provides fully executable, copy-paste-ready guidance: a complete OD dispatch bash script with the wait-loop, concrete HTML/CSS/GSAP examples, attribute tables with exact values, and named commands (lint, validate, inspect) — matching the top anchor's 'specific examples cover the common cases'. | 5 / 5 |
Workflow Clarity | Sequenced processes (Approach → Layout Before Animation → render → Output Checklist → Quality Checks) with explicit validation checkpoints (lint/validate/inspect/contrast/animation-map) and feedback loops ('Re-run hyperframes validate until clean', 'If errors: fix and re-validate'), and a checklist — matching the top anchor; the render operation is not destructive and validation is present so no cap applies. | 5 / 5 |
Progressive Disclosure | Structure and signaling are good (a 'References (loaded on demand)' section with a 'Read when...' trigger per file, content split into captions/tts/audio-reactive/typography/etc.), but four referenced files are missing from the bundle — including load-bearing house-style.md (the default-motion authority cited repeatedly) and visual-styles.md (the 8-preset source central to the Visual Identity Gate), plus patterns.md and data-in-motion.md — so navigation is broken beyond a 'minor organization gap'; transitions.md also routes to a 2-level-deep transitions/catalog.md. | 3 / 5 |
Total | 17 / 20 Passed |