Content
75%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 well-crafted parameter reference: token-dense tables, exact values, clear technique selection, and an anti-patterns checklist, with deferred code keeping the body lean. The main gaps are the unresolvable `examples/gsap-implementation.md` pointer and duplicated comparison tables that could be merged.
Suggestions
Ship `examples/gsap-implementation.md` in the bundle (or inline one complete cut-the-curve GSAP timeline) so the "Code" section's pointer resolves — actionability currently rests on a file not present.
Merge the opening "Catalog" table with the near-duplicate "Choosing a Variant" table (they repeat scope/axis/travel/eases) into a single selection table.
State where `motion-doctrine` and `seam-craft` live (sibling skill paths) so the "read it first" instruction is actionable from this skill alone.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense parameter tables with no filler — it assumes GSAP knowledge, never explaining what a library or ease is, and every section carries exact values (e.g. "±230px (~12% frame)", "0.34s power4.in", "0.05s × 0.84 decay"). It falls short of 5 because content is duplicated: the "Choosing a Variant" table largely restates the opening "Catalog" table, and the Anti-Patterns table repeats rules already given in sections 1–7. | 4 / 5 |
Actionability | Guidance is highly concrete — exact eases, durations, scales, blur peaks, opacity values, and stagger timings per technique, enough to author the tweens directly. Not a 5 because the body contains zero executable code and its sole code pointer ("All GSAP code templates... live in `examples/gsap-implementation.md`") targets a file that does not exist in this bundle, leaving a minor but real gap between parameters and a copy-paste-ready template. | 4 / 5 |
Workflow Clarity | A reference catalog rather than a linear procedure, but it sequences use well: an ordered reading path ("read it first" → motion-doctrine), a catalog with a "Use for" column, a "Choosing a Variant" decision table, and an Anti-Patterns checklist that functions as verification before shipping. Not a 5 because there are no worked end-to-end examples or explicit checkpoints tying the pieces into one authoring pass. | 4 / 5 |
Progressive Disclosure | Good structure: parameters inline in SKILL.md, with clearly signaled one-level-deep pointers ("motion-doctrine", "seam-craft", "examples/gsap-implementation.md") that keep the body lean. Docked from 5 because no bundle files exist (no references/, scripts/, assets/, or examples/), so the load-bearing `examples/gsap-implementation.md` reference cannot be resolved — navigation depends on files outside this bundle. | 4 / 5 |
Total | 16 / 20 Passed |