When your animation feels off but you can't articulate why, this gives you a systematic checklist tied to the 12 principles. It maps symptoms like "floaty" or "stiff" to specific violated principles, then walks through concrete fixes. The diagnostic framework is the real value here: instead of randomly tweaking timing or adding more frames, you isolate whether the problem is missing arcs, poor anticipation, or insufficient squash and stretch. It enforces the discipline of changing one thing at a time so you actually learn what works. Best used when you're stuck tweaking the same scene for hours without improvement.

skills.sh installs
534
GitHub stars
146
last updated
Aug 21, 2026

Install

$ npx -y skills add dylantarre/animation-principles --skill problem-diagnosis --agent claude-code

Installs into .claude/skills of the current project.

Files

Problem Diagnosis

Think like a doctor examining symptoms. Something feels wrong. Your job is to identify the specific principle being violated and prescribe the cure. Systematic diagnosis beats random fixes.

Core Mental Model

When animation feels off, ask: What principle is being violated, and how?

"It doesn't look right" isn't actionable. The 12 principles are your diagnostic checklist. Every animation problem is a principle problem—find which one, and the solution becomes clear.

Diagnostic Framework

Symptom: "Floaty" or "Weightless"

Likely Causes:

  • Missing slow-in/slow-out (objects should accelerate with gravity)
  • Insufficient anticipation before jumps
  • No squash on landing impacts
  • Timing too uniform (everything same speed)
  • Missing secondary weight (hair/clothing not responding to gravity)

Fixes:

  1. Add ease-in at motion start
  2. Add squash frames at impact points
  3. Include settling oscillations after stops
  4. Vary timing based on mass

Sponsors

Details

Repository
github.com/dylantarre/animation-principles
Categories
Debugging, Design & UI/UX
First seen
Jun 3, 2026

More from dylantarre/animation-principles

All 144

Recommended

More Debugging
1andreadellacorte avatargroove-utilities-memory-mistakesandreadellacorte/grooveLog a workflow mistake, fix its root cause, and graduate the lesson to learned memory. Use when the agent makes an error you want to prevent recurring.529skills.sh installs
2jezweb avatarai-sdk-uijezweb/claude-skillsBuild React chat interfaces with Vercel AI SDK v6. Covers useChat/useCompletion/useObject hooks, message parts structure, tool approval workflows, and 18 UI err517skills.sh installs
3bmad-labs avatartypescript-unit-testingbmad-labs/skillsUnit testing for TypeScript/NestJS projects using Jest, @golevelup/ts-jest (DeepMocked/createMock), and in-memory databases, with AAA structure. Use whenever th511skills.sh installs
4posthog avatarreact-doctorposthog/posthogDiagnose and fix React codebase health issues. Use when reviewing React code, fixing performance problems, auditing security, or improving code quality.507skills.sh installs
5jezweb avatarplaywright-localjezweb/claude-skillsBuild browser automation and web scraping with Playwright on your local machine. Prevents 10 documented errors including CI timeout hangs, extension testing fai505skills.sh installs
6rshankras avatargeneratorsrshankras/claude-code-apple-skillsCode generator skills that produce production-ready Swift code for common app components. Use when user wants to add logging, analytics, onboarding, review prom505skills.sh installs