Content
82%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-structured, highly actionable reference: every utility has an executable example with expected output, plus best-practices and do-not sections that guide correct usage. The main improvements are de-duplicating the repeated 'function form' pattern and moving the exhaustive per-function reference into a separate bundle file to keep SKILL.md as an overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean reference that explains only GSAP-specific, non-obvious conventions (the 'omit the value to get a function' pattern) and never explains concepts Claude already knows, but that pattern is restated in roughly eight per-function sections after the Overview already establishes it — minor over-explanation that could be trimmed, matching anchor 4 rather than anchor 5. | 4 / 5 |
Actionability | Every util has a signature plus copy-paste-ready executable code with expected outputs (e.g. 'gsap.utils.clamp(0, 100, 150); // 100'), and distribute() gets a full config table with both tween and manual-call usage — fully executable guidance covering the common cases, matching anchor 5. | 5 / 5 |
Workflow Clarity | This is a single-purpose utility reference with no multi-step process and no destructive or batch operations, so no validation checkpoints are needed and usage per function is unambiguous; however, guidance for choosing between overlapping utils (mapRange vs normalize, snap vs random's snapIncrement) is mostly implied rather than explicit, which is the minor gap of anchor 4. | 4 / 5 |
Progressive Disclosure | Sections are well-organized with clear headers and clearly signaled one-level-deep links to official gsap.com docs (no nested references), but ~280 lines of full API reference are inlined in SKILL.md where a split — overview and key patterns here, per-function details in a references/ file — would fit better, matching anchor 4's 'most content appropriately placed; minor organization gaps' rather than anchor 5's appropriate split. | 4 / 5 |
Total | 17 / 20 Passed |