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.
This is a highly actionable, well-structured reference with executable examples throughout and clear decision and repair workflows. Its weaknesses are systematic rule repetition that inflates token cost, and incomplete progressive disclosure — one of the two reference files is never linked from the SKILL.md index.
Suggestions
Link `references/animation-prompt-cookbook.md` from SKILL.md (e.g., in the intro alongside data-anim.md: "For per-type prompt recipes, read `references/animation-prompt-cookbook.md`") so the whole bundle is navigable from the index.
De-duplicate repeated rules: state the runtime-only attribute ban and the no-manual-hidden-state rule once in "Hard rules" and have "Preview-only boundary" / "Failure repair strategy" reference them instead of restating them verbatim.
Collapse the duplicated old/new stagger and "with" examples into one preferred-syntax example per pattern, or move the legacy `data-anim-delay="stagger(N)"` form into a clearly labeled compatibility note.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly tight (tables, terse rules, compact snippets), but several rules are stated verbatim twice — the runtime-only easing/repeat/direction ban appears in "Preview-only boundary" and again in "Hard rules", the no-manual-hidden-state rule appears in "Hard rules" and again in "Failure repair strategy", and the stagger and "with" patterns each get duplicated old/new-syntax example pairs. This matches "mostly efficient but includes some unnecessary explanation or could be tightened"; not 4 because the duplication is systematic rather than a couple of trimmable lines. | 3 / 5 |
Actionability | Guidance is fully executable: complete copy-paste HTML snippets for every trigger pattern, an exhaustive supported-types list, a full attribute table with value domains, a concrete `PPT.animate(targets, params)` example, and a directional-examples block. The repair strategy gives exact checks ("replace `anime(...)` with `PPT.animate(...)`"), matching "copy-paste ready ... specific examples cover the common cases". | 5 / 5 |
Workflow Clarity | The "30-second decision checklist" gives an explicit pre-work sequence (reading path → trigger → type → duration) and the "Failure repair strategy" is a numbered 1-4 diagnostic loop with concrete fixes, which is a genuine feedback loop. Not 5 because the add-animation path has no verification step (e.g., confirm the animation plays in preview before considering the slide done); not 3 because checkpoints are explicit in both the checklist and repair sections. | 4 / 5 |
Progressive Disclosure | The pointer to `references/data-anim.md` is clear and well-signaled at the top, but the bundle also contains `references/animation-prompt-cookbook.md` (~15KB of per-type prompt recipes) which is never mentioned in SKILL.md, making it undiscoverable; additionally the inline supported-types list overlaps the mapping table already in the reference. This matches "some structure but could be better organized"; not 4 because an entire bundle file being orphaned from the index is more than a minor gap. | 3 / 5 |
Total | 15 / 20 Passed |