CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

improve-animations

Survey a codebase's animation and motion code as a senior motion advisor, then produce a prioritized audit and self-contained implementation plans for other agents (or cheaper models) to execute. Read-only on source code — it plans improvements, it does not apply them. Use when the user asks to "improve the animations", "audit the motion", "make this app feel better", or wants a roadmap of animation fixes rather than a review of a single diff.

Quality

93%

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

The canonical home for this skill is improve-animations in emilkowalski/skills

SKILL.md
Quality
Evals
Security

Quality

Content

92%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-engineered advisor workflow: lean overview, exhaustive concrete guidance, a vetted/prioritized pipeline with explicit validation checkpoints, and textbook progressive disclosure to two clearly signaled reference files. The only deduction is minor rhetorical flourish in the persona and tone sections.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious, skill-specific guidance (grep sweeps, effort table, severity definitions, subagent prompt requirements) and explains almost nothing Claude already knows. Minor flourishes could still be trimmed — 'a senior design engineer with a brutal eye for craft', 'the ease-in that makes every dropdown feel sluggish' — landing it just below the 'every token earns its place' anchor. It is clearly above 'minor instances of over-explanation' only in the sense that the persona/tone flourishes are deliberate but expendable, so 4 fits best.

4 / 5

Actionability

For an instruction-only skill, the guidance is fully concrete: copy-paste grep patterns ('transition', '@keyframes', 'prefers-reduced-motion'…), a numeric effort table (quick/standard/deep with subagent counts and finding counts), exact plan naming ('plans/NNN-short-slug.md', 'git rev-parse --short HEAD'), mandated plan contents (exact cubic-beziers, durations, file:line excerpts), and per-variant behaviors. Specific examples cover the common cases, matching the top anchor.

5 / 5

Workflow Clarity

Four clearly sequenced phases (recon → audit → vet/prioritize/confirm → plans) with explicit validation checkpoints: re-read cited code for every finding, reject by-design/duplicate findings ('Never present a finding you haven't confirmed at its file:line'), stop and wait for user selection, and a verification/feel-check section in every plan. The 'reconcile' variant even provides a re-check loop. This matches the anchor for clear sequence with explicit validation steps and feedback loops.

5 / 5

Progressive Disclosure

The body is an overview that delegates the rule catalog and plan format to clearly signaled, one-level-deep references — '[AUDIT.md](AUDIT.md)', '[PLAN-TEMPLATE.md](PLAN-TEMPLATE.md)' — with explicit load timing ('Load them when you audit and when you write plans'). No bundle files are present to verify, but judged on reference structure alone the split is clean and navigation is easy, matching the top anchor.

5 / 5

Total

19

/

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 description: concrete multi-action capability statement in third person, an explicit 'Use when…' clause with natural quoted trigger phrases, and clear boundary marking against a single-diff review skill. The only gap is that keyword coverage, while good, misses a few natural synonyms (micro-interactions, transitions, motion polish).

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Survey a codebase's animation and motion code', 'produce a prioritized audit and self-contained implementation plans for other agents (or cheaper models) to execute', 'Read-only on source code — it plans improvements, it does not apply them' — with comprehensive coverage of the skill's capabilities in third-person voice. It matches the anchor for multiple specific concrete actions; score 4 would require noticeable gaps in coverage, which are absent.

5 / 5

Completeness

It explicitly answers both questions: what ('Survey a codebase's animation and motion code … produce a prioritized audit and self-contained implementation plans') and when ('Use when the user asks to…'), with concrete trigger phrases. This matches the anchor 'clearly and explicitly answers both what AND when with concrete trigger phrases'.

5 / 5

Trigger Term Quality

It quotes natural user phrases directly — '"improve the animations"', '"audit the motion"', '"make this app feel better"', 'a roadmap of animation fixes' — which is good, natural keyword coverage rather than jargon. It falls short of the comprehensive-coverage anchor because a few terms users would plausibly say are missing (e.g. 'micro-interactions', 'transitions', 'springs', 'motion polish').

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche (whole-codebase animation/motion audit and planning, read-only, plans for executors) and explicitly excludes the neighboring case — 'rather than a review of a single diff' — so it is unlikely to trigger for the wrong skill. Minimal conflict risk matches the top anchor.

5 / 5

Total

19

/

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

relative_links

Relative link issues: 4 missing

Warning

Total

15

/

16

Passed

Repository

jscraik/websites

Path

.codex/skills/improve-animations/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.