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-choreographyInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
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.
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 foundOur 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.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| nw-interaction-choreography (this skill)by nWave-ai | 90 | 617 | 2mo ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 47.3k | 2d ago | CLAUDE.md |
| lobehubby lobehub | 100 | 85.6k | today | MCP 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.
Skill content
View source on GitHubname: 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
- Border appears (0-80ms): 1px border fades in at accent color
- Background fills (80-200ms): glassmorphism backdrop fades in
- Content enters (200-400ms): text and elements fade-up with stagger
- 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:
- Border color transition (200ms, ease-morph)
- Background ambient color shift (300ms, ease-morph)
- Status indicator pulse once (400ms, ease-bounce)
- Settle into new steady state
Warning -> Critical:
- Quick flash (80ms white at 10% overlay)
- Border + background snap to critical color (150ms, ease-enter-sharp)
- 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
transformandopacityfor animations (GPU-composited, no layout thrashing) - Declare
will-changeon 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
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
47.3kA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
lobehub
85.6k🤯 LobeHub - Super-Agents on Your Team. Add super-agents to the chats your team already uses.They take on work by themselves and get better every week.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
