CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

gsap-utils

Official GSAP skill for gsap.utils — clamp, mapRange, normalize, interpolate, random, snap, toArray, wrap, pipe. Use when the user asks about gsap.utils, clamp, mapRange, random, snap, toArray, wrap, or helper utilities in GSAP.

68

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

82%Weight 40%Scale 1-5

Reviews 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.

DimensionReasoningScore

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

Description

83%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description that names the domain, lists concrete API functions, and includes an explicit 'Use when' clause with natural trigger terms. The main weaknesses are incomplete function coverage relative to the body and generic word triggers that carry some overlap risk with non-GSAP contexts.

Suggestions

Mention the remaining utils the body documents (e.g. getUnit, unitize, splitColor, selector, distribute, shuffle, wrapYoyo) or summarize them as 'plus unit parsing, color splitting, and scoped selection helpers' so the description's coverage matches the skill's actual scope.

Qualify generic trigger words with the GSAP context (e.g. 'clamp or mapRange values in GSAP animations') to reduce conflict with non-GSAP uses of 'clamp', 'random', 'wrap', and 'snap'.

Add a few natural synonyms such as 'GSAP utility functions' or 'lerp/interpolation' to broaden trigger coverage for users who phrase requests differently.

DimensionReasoningScore

Specificity

The description lists nine concrete API functions ("clamp, mapRange, normalize, interpolate, random, snap, toArray, wrap, pipe") rather than vague language, but omits roughly seven utils documented in the body (getUnit, unitize, splitColor, selector, distribute, shuffle, wrapYoyo), which is more than a minor gap, fitting anchor 4 ('lists several specific actions; minor gaps in coverage') better than anchor 5's 'comprehensive coverage' and well above anchor 3's '1-2 concrete actions'.

4 / 5

Completeness

It clearly answers both questions: what it does ("Official GSAP skill for gsap.utils — clamp, mapRange, normalize, interpolate, random, snap, toArray, wrap, pipe") and when to use it via an explicit "Use when the user asks about gsap.utils, clamp, mapRange, random, snap, toArray, wrap, or helper utilities in GSAP" clause with concrete trigger phrases — an exact match for anchor 5, mirroring the good_overall_example pattern.

5 / 5

Trigger Term Quality

Triggers like "gsap.utils", "clamp", "mapRange", "random", "snap", "toArray", "wrap" are exactly what a GSAP user would type, giving good keyword coverage, but a few natural terms are missing (e.g. 'GSAP utility functions', 'lerp', 'interpolation', 'shuffle'), which matches anchor 4 rather than anchor 5's comprehensive synonym-level coverage.

4 / 5

Distinctiveness Conflict Risk

"Official GSAP skill for gsap.utils" carves out a clear niche with mostly distinct triggers, but generic English trigger words like "clamp", "random", "wrap", and "snap" could fire for non-GSAP contexts (CSS clamp(), generic math), which is the minor overlap risk of anchor 4 rather than anchor 5's minimal conflict risk.

4 / 5

Total

17

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

nexu-io/open-design

Path

skills/gsap-utils/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.