calm-relaxation — Claude Code skill: soothing animations
A skill for AI coding that sets rules for gentle, quiet motion: long timings, soft easing curves, no sudden jumps.
npx skills add dylantarre/animation-principles --skill calm-relaxation -a claude-codeWhat calm-relaxation does
The skill explains how to build animations that settle rather than grab attention: breathing, drifting, slow fades. It maps twelve Disney animation principles onto a calm register — squash and stretch kept to 2–5%, anticipation stretched to 200–400ms, follow-through with settling times of 500ms and up. A timing table and ready CSS variables for the curves come with it.
For breathing there is a calm-breathe keyframe set: scale from 1 to 1.02, opacity from 0.8 to 1 over 5 seconds. The curves are cubic-bezier(0.4, 0, 0.6, 1) for gentle motion and cubic-bezier(0.37, 0, 0.63, 1) for floating. All plain CSS, no libraries.
Use it for meditation apps, loading screens, ambient backgrounds, night mode transitions. If your project already runs fast, punchy animations, these rules will fight them — you have to pick which rhythm stays.
What it helps with
- build a breathing pulse that never jitters
- pick duration and easing for a drifting background
- design a loading screen that does not annoy
- soften the switch into night mode
- fade an element in without a hard start
Example prompts for the agent
- add a calm-relaxation breathing animation to this card
- pick timings and easing for floating particles using the calm-relaxation skill
- redo the night mode transition the calm way, like calm-relaxation
How to install calm-relaxation
1Skills CLI (Vercel)
npx skills add dylantarre/animation-principles --skill calm-relaxation -a claude-code2Manually: put the files in place
~/.claude/skills/calm-relaxation/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/calm-relaxation/
1Skills CLI (Vercel)
npx skills add dylantarre/animation-principles --skill calm-relaxation -a codex2Manually: put the files in place
.agents/skills/calm-relaxation/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add dylantarre/animation-principles --skill calm-relaxation -a cursor2Manually: put the files in place
.cursor/skills/calm-relaxation/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install dylantarre/animation-principles calm-relaxation2Manually: put the files in place
.github/skills/calm-relaxation/SKILL.md1Skills CLI (Vercel)
npx skills add dylantarre/animation-principles --skill calm-relaxation -a gemini-cli2Platform CLI
gemini skills install https://github.com/dylantarre/animation-principles --path skills/06-by-emotional-outcome/calm-relaxationManually: put the files in place
.devin/skills/calm-relaxation/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add dylantarre/animation-principles --skill calm-relaxation -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about calm-relaxation
How do I install calm-relaxation in Claude?
Run npx skills add dylantarre/animation-principles --skill calm-relaxation -a claude-code. The skill file lands at ~/.claude/skills/calm-relaxation/SKILL.md.
What does calm-relaxation do?
It sets rules for soothing animation: long durations, soft curves, almost no exaggeration. It keeps the agent from producing jumpy interface motion.
What timings does the skill recommend?
Fades run 400–600ms, floating elements 3000–5000ms, breathing 4000–6000ms. The easing curves are given as cubic-bezier values.
Source text
SKILL.md · MIT
---
name: calm-relaxation
description: Use when creating animations that soothe users, reduce anxiety, or create peaceful, meditative experiences.
---
# Calm & Relaxation Animation
Create animations that soothe, settle, and create peaceful user experiences.
## Emotional Goal
Calm emerges from slow, gentle, predictable motion. Relaxation comes from animations that breathe, flow naturally, and never demand attention or create tension.
## Disney Principles for Calm
### Squash & Stretch
Very subtle (2-5%). Gentle breathing or pulsing rather than bouncing. Soft, organic deformation like clouds or water.
### Anticipation
Long, gradual preparation (200-400ms). Slow builds create no surprises. Everything telegraphed well in advance.
### Staging
Soft focus, ambient positioning. No aggressive attention-grabbing. Elements share space harmoniously without competition.
### Straight Ahead Action
Gentle, organic flow for ambient animations. Drifting clouds, floating particles, subtle gradients—natural randomness.
### Follow Through & Overlapping Action
Extended, graceful follow-through. Long settling times (500ms+). Elements drift to rest like leaves on water.
### Slow In & Slow Out
Heavy easing on both ends. Very gradual acceleration and deceleration. `cubic-bezier(0.4, 0, 0.6, 1)` for smooth, gentle motion.
### Arc
Wide, sweeping curves. Gentle parabolas. Motion should flow like water or wind—never angular or abrupt.
### Secondary Action
Ambient, background motion. Subtle parallax, gentle floating elements. Supporting motion that doesn't demand attention.
### Timing
Slow and deliberate (400-800ms+). Long durations feel meditative. No quick movements. Breathing rhythm: 4-6 seconds per cycle.
### Exaggeration
Minimal to none. Realistic, natural movements. Subtlety is calming; exaggeration creates tension.
### Solid Drawing
Soft edges, rounded forms. No sharp angles. Organic shapes that feel natural and comfortable.
### Appeal
Soft colors, low contrast. Gentle gradients. Rounded shapes. Natural, organic aesthetics.
## Timing Recommendations
| Element | Duration | Easing |
|---------|----------|--------|
| Fade transitions | 400-600ms | `ease-in-out` |
| Floating elements | 3000-5000ms | `ease-in-out` |
| Breathing pulse | 4000-6000ms | `ease-in-out` |
| Parallax drift | 800-1200ms | `ease-out` |
## CSS Easing
```css
--calm-gentle: cubic-bezier(0.4, 0, 0.6, 1);
--calm-float: cubic-bezier(0.37, 0, 0.63, 1);
--calm-breathe: cubic-bezier(0.45, 0, 0.55, 1);
```
## Breathing Animation
```css
@keyframes calm-breathe {
0%, 100% {
transform: scale(1);
opacity: 0.8;
}
50% {
transform: scale(1.02);
opacity: 1;
}
}
.breathing-element {
animation: calm-breathe 5s ease-in-out infinite;
}
```
## When to Use
- Meditation and wellness apps
- Loading states for long processes
- Ambient backgrounds
- Reading experiences
- Night mode transitions
- Healthcare interfaces
- Onboarding welcome screens
- Success states that don't need celebration
© dylantarre · MIT · dylantarre/animation-principles