Content
71%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 lean, opinionated, highly actionable review skill with a rigid output contract — no padding, no explanations of known concepts, concrete values throughout. Its main weaknesses are the dangling STANDARDS.md reference that the body depends on for every recommended value, and a review sequence that is implied by structure rather than stated explicitly.
Suggestions
Ship STANDARDS.md in the bundle (or inline the key duration/easing tables) so the repeated instruction to pull exact values from it can actually be executed.
Add a short numbered review sequence up front (enumerate animations in the diff → apply the ten standards → check escalation triggers → produce the two-part output) to make the workflow explicit rather than implied.
Verify the ../choreograph/SKILL.md cross-reference resolves in the installed layout, or describe the 30–80ms stagger rule inline and drop the link.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and imperative and explains nothing Claude already knows — no definition of easing, transitions, or CSS animation; every section states rules ("UI animations stay under 300ms", "Never animate from `scale(0)`"). Minor trimmable instances exist: the Aggressive Escalation Triggers list restates standards 3, 5, 7, and 8, and the canned "Initial Response" greeting adds tokens. Fits anchor 4 (efficient, minor instances that could be trimmed); not 5 because of that duplication and boilerplate. | 4 / 5 |
Actionability | Guidance is highly concrete for an instruction-only skill: exact thresholds (sub-300ms, 400ms `ease` toasts, `scale(0.9–0.97)`), exact properties and media queries (`@media (hover: hover) and (pointer: fine)`), a filled-in Before/After/Why example table, an ordered remedial hierarchy with specific swaps, and explicit Block/Approve criteria. It stops short of anchor 5 because every recommended value (curves, duration tables, spring configs) is deferred to STANDARDS.md, which is not present in the bundle, so "pull the exact one from STANDARDS.md" cannot be executed as provided. | 4 / 5 |
Workflow Clarity | The review flow is legible through section order (posture → standards → on-sight triggers → fix hierarchy → required output), with one explicit checkpoint ("Read it before you write the verdict") and a rigid two-part output format capped by an explicit Block/Approve decision protocol that validates the verdict. Fits anchor 4 (clear sequence, most checkpoints present); not 5 because the sequence is never stated as explicit numbered steps for entering the review (e.g., enumerate animations in the diff first). | 4 / 5 |
Progressive Disclosure | The design intent is textbook progressive disclosure — an overview SKILL.md deferring the full rule catalog to a clearly signaled, one-level-deep [STANDARDS.md](STANDARDS.md) — but the actual bundle contains no STANDARDS.md (and no ../choreograph/SKILL.md), so the central reference that carries the skill's values is dangling. Scoring against the actual bundle structure, this fits anchor 3 (references present, structure undermined); not 4 because the most important referenced path does not resolve, and not 2 because the inline content is genuinely overview-level rather than inlined reference material. | 3 / 5 |
Total | 15 / 20 Passed |