Skip to main content
skill CX Codex

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.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add dylantarre/animation-principles --skill calm-relaxation -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/calm-relaxation/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/calm-relaxation/

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

Similar skills

Everything for Frontend and UI →

From the same set86

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor