improve-animations

Audits a codebase's animations against motion design rules and writes executable improvement plans.

1|1|Updated May 11, 2026
One-click install
npx skills add https://github.com/taxmaxi/taxmaxi --skill improve-animations-taxmaxi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: improve-animations
Source: https://github.com/taxmaxi/taxmaxi/tree/main/.codex/skills/improve-animations
Command: npx skills add https://github.com/taxmaxi/taxmaxi --skill improve-animations-taxmaxi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Web animations often feel sluggish, robotic, or jarring because of subtle defects like ease-in curves on UI interactions, keyframes that restart mid-flight, or missing reduced-motion handling. This Skill systematically audits a codebase's motion against the animations.dev craft bar and produces precise, self-contained fix plans that another agent can execute without any design judgment. ## Core Features & Use Cases - Eight-category motion audit: Covers purpose and frequency, easing and duration, physicality and origin, interruptibility and springs, performance, accessibility, cohesion, and missed opportunities, each with exact replacement values like cubic-bezier curves and duration budgets. - Read-only analysis with severity ranking: Never modifies source code; vets every finding at its file:line, rejects exempt patterns, and ranks survivors by leverage in a severity table. - Self-contained plan generation: Writes plans to plans/ with exact current-code excerpts, target values, repo conventions, ordered steps, and feel-check verification so an executor with zero context can implement them. - Use Case: Point it at a React app using Radix and Tailwind where dropdowns feel sluggish; it identifies the ease-in curve and 300ms duration, then writes a plan specifying the exact 180ms cubic-bezier(0.19, 1, 0.22, 1) replacement. ## Quick Start Ask the agent to audit the animations in this repository and write improvement plans for the highest-impact findings.

Frequently Asked Questions about improve-animations

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit animations in a React codebase?▼

Run this Skill against the repository and it maps the motion stack, sweeps for transitions, keyframes, and spring usage, then applies eight audit categories covering easing, performance, and accessibility. Findings are ranked by severity with exact file and line references.

What animation issues does this audit detect?▼

It detects ease-in curves on UI interactions, keyframes on re-triggerable elements, scale(0) entrances, wrong transform-origin on popovers, layout-property animation, missing prefers-reduced-motion handling, and excessive durations. Each finding cites the exact replacement value from the rule catalog.

Does this Skill modify my source code?▼

No, it is strictly read-only on source code. It only creates plan files under plans/ containing exact current-code excerpts, target values, and verification steps that a separate executor agent or developer implements.

Can I audit only performance or accessibility issues?▼

Yes, invoking it with a category name like performance, accessibility, easing, or cohesion runs recon plus only that category. You can also use quick or deep to adjust audit coverage and subagent fan-out.

Why do my CSS animations feel sluggish even at short durations?▼

Sluggish feel usually comes from a weak easing curve rather than duration; built-in curves like ease-in delay the start of motion exactly when the user is watching. The audit recommends steep cubic-bezier curves like cubic-bezier(0.19, 1, 0.22, 1) tuned before adjusting duration.