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.

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

71%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 thorough, highly actionable gsap.utils reference with excellent executable examples, but it is long and inlines the entire API surface rather than splitting detail into a bundled reference file, and repeats the function-form explanation.

Suggestions

Move the full per-utility API reference into a bundled references/ file (e.g. API.md) and keep SKILL.md as an overview pointing to it, so progressive_disclosure can score higher.

Consolidate the 'omit the value to get a function' explanation into the overview once instead of restating it under clamp, mapRange, normalize, interpolate, snap, wrap, and wrapYoyo.

Tighten the overview section by removing prose that duplicates the per-function examples to improve token efficiency.

Dimension	Reasoning	Score
Conciseness	The reference assumes Claude's competence without concept filler, but the 'Omitting the value' overview paragraph is repeated per-function and the ~280-line body could be tightened by consolidating the function-form explanations.	3 / 5
Actionability	Nearly every utility ships copy-paste-ready JavaScript with concrete inputs and expected outputs, covering value, function-form, and array variants plus the distribute config table.	5 / 5
Workflow Clarity	Clear 'When to Use', 'Best practices', and 'Do Not' sections give unambiguous decision guidance with no destructive/batch operation needing validation, though it is a reference rather than a sequenced multi-step workflow.	4 / 5
Progressive Disclosure	Well-organized with clear section headers and one-level external gsap.com links, but the full ~280-line API surface is inlined in SKILL.md with no bundle split, fitting the 'content that should be separate is inline' pattern.	3 / 5
	Total	15 / 20 Passed

Description

92%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, specific description that clearly states both capabilities and trigger conditions with named GSAP utilities. The only gap is the trigger-term list not fully mirroring the capability list and missing a few synonyms.

Dimension	Reasoning	Score
Specificity	Names the domain (gsap.utils) and enumerates nine concrete utilities — clamp, mapRange, normalize, interpolate, random, snap, toArray, wrap, pipe — giving comprehensive coverage of specific actions.	5 / 5
Completeness	It explicitly answers both 'what' (Official GSAP skill for gsap.utils and the named helpers) and 'when' ('Use when the user asks about...') with concrete trigger phrases.	5 / 5
Trigger Term Quality	The 'Use when' clause lists natural terms users would say (gsap.utils, clamp, mapRange, random, snap, toArray, wrap), but it omits interpolate and pipe from the trigger list and lacks synonyms like 'lerp', so a few natural terms are missing.	4 / 5
Distinctiveness Conflict Risk	Scoped to GSAP's official gsap.utils with named API members as triggers, giving it a clear niche with minimal conflict risk against other skills.	5 / 5
	Total	19 / 20 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
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
Commit: df84ae5

Reviewed: 4 days ago

Table of Contents

Discovery Implementation Validation

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.