SkillAgentSearch skills...

nw-interaction-choreography

Animation principles, timing, easing curves, and choreography sequences for futuristic interfaces -- motion as communication

Install / Use

npx skills add nWave-ai/nWave --skill nw-interaction-choreography

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

90/100

Supported Platforms

Universal

Tags

Our assessment of nw-interaction-choreography

nw-interaction-choreography scores 90/100 on our quality scale, 1429th of 4,698 Development & Engineering skills we index (top 31%).

Its SKILL.md is 6.9 KB long, well organised into 21 sections with 8 code examples: a thorough specification that gives an agent plenty to work with.

It has 617 GitHub stars, a meaningful sign that others use it.

Substance
29/30
Structure
20/20
Description
15/15
Adoption
12/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so nw-interaction-choreography is actively maintained.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-11-10. Automated pattern scan on 2026-11-10. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

nw-interaction-choreography compared with similar skills

All 4 of these similar skills score higher than nw-interaction-choreography; compare them before choosing.

SkillScoreStarsUpdatedFormat
nw-interaction-choreography (this skill)by nWave-ai906172mo agoSKILL.md
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
ai-job-searchby ai-job-search-dev10072.1ktodayCLAUDE.md
claude-howtoby luongnv8910047.3k2d agoCLAUDE.md
lobehubby lobehub10085.6ktodayMCP Server

Frequently asked questions

How do I install nw-interaction-choreography?
Run npx skills add nWave-ai/nWave --skill nw-interaction-choreography. The install tabs above show the steps for each supported agent.
Which AI agents does nw-interaction-choreography work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is nw-interaction-choreography safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is nw-interaction-choreography still maintained?
The repository was last updated about 2 months ago, so nw-interaction-choreography is actively maintained.

name: nw-interaction-choreography description: Animation principles, timing, easing curves, and choreography sequences for futuristic interfaces -- motion as communication user-invocable: false disable-model-invocation: true

Interaction Choreography

Motion Philosophy

Every animation communicates exactly one thing: spatial relationship, state change, hierarchy shift, or attention redirection. If you cannot name what a motion communicates, remove it.

Timing Framework

Duration Scale

--duration-instant:  0ms        -- immediate state (disabled toggle)
--duration-micro:    80-120ms   -- micro-feedback (button press, toggle)
--duration-fast:     150-200ms  -- hover states, tooltips, color transitions
--duration-normal:   250-350ms  -- panel open/close, content swap
--duration-slow:     400-600ms  -- major layout shifts, page transitions
--duration-dramatic: 800-1200ms -- onboarding reveals, hero animations

Rule of Perceptible Motion

  • Under 100ms: perceived as instant (use for feedback acknowledgment)
  • 100-300ms: perceived as responsive (primary interaction range)
  • 300-600ms: perceived as animated (layout and navigation)
  • Over 600ms: perceived as cinematic (use sparingly -- first impressions, celebrations)

Easing Curves

Futuristic Easing Library

/* Entrance -- elements appearing */
--ease-enter: cubic-bezier(0.0, 0.0, 0.2, 1.0);     /* decelerate into place */
--ease-enter-sharp: cubic-bezier(0.0, 0.0, 0.1, 1.0); /* snap into position (HUD feel) */

/* Exit -- elements leaving */
--ease-exit: cubic-bezier(0.4, 0.0, 1.0, 1.0);       /* accelerate out */
--ease-exit-sharp: cubic-bezier(0.4, 0.0, 0.8, 1.0);  /* quick departure */

/* State change -- morphing in place */
--ease-morph: cubic-bezier(0.4, 0.0, 0.2, 1.0);      /* standard Material-style */
--ease-bounce: cubic-bezier(0.34, 1.56, 0.64, 1.0);   /* slight overshoot (playful) */

/* Sci-fi signature -- sharp start, elastic end */
--ease-cyber: cubic-bezier(0.0, 0.8, 0.2, 1.0);      /* immediate response, gentle settle */
--ease-glitch: steps(8, end);                           /* digital artifact feel */

Easing Selection Guide

| Interaction Type | Easing | Rationale | |-----------------|--------|-----------| | Button press | ease-enter-sharp | Immediate feedback, decisive | | Panel open | ease-enter | Smooth revelation | | Panel close | ease-exit-sharp | Quick, respectful of attention | | Hover glow | ease-morph | Gentle state acknowledgment | | Error shake | ease-bounce | Attention + slight playfulness | | Data refresh | ease-cyber | Responsive start, settle into new values | | Loading pulse | ease-morph (looped) | Rhythmic, non-distracting | | Glitch effect | ease-glitch | Digital/mechanical feel |

Choreography Sequences

Staggered Reveal (Grid/List Items)

Items enter sequentially with delay multiplication:

Item 1: delay 0ms,   duration 300ms
Item 2: delay 50ms,  duration 300ms
Item 3: delay 100ms, duration 300ms
Item N: delay (N-1)*50ms

Cap at 400ms total stagger (8 items). Beyond that, reveal in groups. Direction: top-left to bottom-right (reading order) or center-out (radial).

Panel Expansion

  1. Border appears (0-80ms): 1px border fades in at accent color
  2. Background fills (80-200ms): glassmorphism backdrop fades in
  3. Content enters (200-400ms): text and elements fade-up with stagger
  4. Interactive elements activate (400-500ms): buttons/inputs become responsive

Collapse: reverse order, 60% of expand duration (faster exit than enter).

State Transitions (Status Changes)

Nominal -> Warning:

  1. Border color transition (200ms, ease-morph)
  2. Background ambient color shift (300ms, ease-morph)
  3. Status indicator pulse once (400ms, ease-bounce)
  4. Settle into new steady state

Warning -> Critical:

  1. Quick flash (80ms white at 10% overlay)
  2. Border + background snap to critical color (150ms, ease-enter-sharp)
  3. Status indicator begins steady pulse (1.5s cycle)

Navigation Transitions

Slide: Content exits left (ease-exit, 200ms) while new content enters right (ease-enter, 250ms, 50ms delay). Maintains spatial metaphor (forward = left-to-right).

Crossfade: Old content fades out (ease-exit, 150ms) while new fades in (ease-enter, 200ms, 100ms overlap). Use when spatial direction is meaningless.

Morph: Shared elements transform between states (ease-morph, 300ms). Hero images, cards that expand to detail views. Maintains object permanence.

Micro-Interactions

Button States

Idle:        scale(1.0), glow(0)
Hover:       scale(1.0), glow(accent 25%), border-opacity -> 60%, 150ms ease-morph
Active/Down: scale(0.98), glow(accent 40%), 80ms ease-enter-sharp
Release:     scale(1.0), ripple-out from click point, 300ms ease-enter
Loading:     border-gradient rotation (1.5s linear infinite), content fade to 60%
Success:     brief glow pulse (accent, 400ms ease-bounce), icon morph
Error:       horizontal shake (3 cycles, 4px amplitude, 300ms), border flash critical

Toggle/Switch

Off -> On:  thumb slides right (200ms ease-cyber), track fills with accent (150ms)
On -> Off:  thumb slides left (150ms ease-exit-sharp), track drains (120ms)

Input Focus

Unfocused -> Focused: bottom-border expands from center (250ms ease-enter), label floats up (200ms ease-morph), glow appears (200ms)
Focused -> Unfocused: glow fades (150ms), label settles if empty (200ms), border returns to default (150ms)

Tooltip / Popover

Trigger: 500ms hover delay (avoid false triggers)
Enter: fade-up 8px + opacity 0->1, 200ms ease-enter, from anchor point
Exit: fade-down 4px + opacity 1->0, 120ms ease-exit-sharp (faster than enter)

Scroll-Linked Effects

  • Parallax: Background layers scroll at 0.3-0.5x content speed. Foreground elements at 1.0x. Creates depth without interaction cost.
  • Reveal on scroll: Elements fade-up as they enter viewport (IntersectionObserver, threshold 0.15). Once revealed, stay revealed (no reverse animation).
  • Sticky headers: Shrink transition (height 64px -> 48px) on scroll-down, expand on scroll-up. Use transform for GPU acceleration.

Reduced Motion

Every choreography MUST have a prefers-reduced-motion alternative:

@media (prefers-reduced-motion: reduce) {
  *, *::before, *::after {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
  }
}

For semantic animations (state changes communicating information): replace motion with instant color/opacity changes. The information must still be communicated, just without movement.

Performance Rules

  • Use transform and opacity for animations (GPU-composited, no layout thrashing)
  • Declare will-change on elements that will animate (remove after animation completes)
  • Avoid animating width, height, top, left, margin, padding -- these trigger layout
  • Cap simultaneous animations at 8-12 elements. Beyond that, group into batches.
  • Test at 4x slowdown in DevTools to catch jank

Related Skills

View on GitHub
GitHub Stars617
CategoryDevelopment
Updated2mo ago
Forks63

Languages

Python

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions