fluid-interface-design
Skill1 starsChanged 4 days agoMITView on GitHub
Platform-neutral guidance for responsive, physical, and accessible interface motion. Use when designing or reviewing direct manipulation, drag and swipe interactions, springs, velocity handoff, momentum, interruptible transitions, sheets, soft boundaries, translucent materials, interaction typography, or reduced-motion behavior on the web or in native apps.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- Aleksandr-Litvinenko/ladny-interfacetheir own version, first seen Aug 9, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- Aleksandr-Litvinenko/ladny-interface★ 6same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository21 other files it gives its agents.
- animation-vocabularySkill
- apple-chartsSkill
- apple-hig-componentsSkill
- apple-hig-foundationsSkill
- apple-hig-getting-startedSkill
- apple-hig-inputsSkill
- apple-hig-patternsSkill
- apple-hig-technologiesSkill
- apple-sheetsSkill
- batch-commitSkill
- git-change-controlSkill
- improve-animationsSkill
- marketing-art-directionSkill
- marketing-product-mediaSkill
- marketing-reference-forensicsSkill
- marketing-visual-qaSkill
- message-delivery-integritySkill
- production-verificationSkill
- product-marketing-personasSkill
- security-auditSkill
- systems-builder-writingSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
24 rules. About 0 are common, 24 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈24
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 17
Remove motion that serves none of those purposes.
- Distinctive: line 25
Keep interactive motion interruptible and redirectable.
- Distinctive: line 26
Start a new transition from the current rendered value, not from a stale logical target.
- Distinctive: line 27
Use the same spatial path for entry and exit unless the change in path carries meaning.
- Distinctive: line 30
Use an easing curve for a short, noninteractive state transition with a known duration.
- Distinctive: line 31
Use a spring when an object can be grabbed, redirected, or handed velocity.
- Distinctive: line 32
Use momentum projection before snapping when a flick should affect the destination.
- Distinctive: line 33
Use progressive resistance at boundaries instead of a hard visual stop.
- Distinctive: line 38
Keep every gesture available through another accessible input path.
- Distinctive: line 41
Test interruption, reversal, rapid repeated input, slow drags, fast flicks, cancellation, and boundary cases.
- Distinctive: line 43
Test on representative low-power and high-refresh-rate devices.
- Distinctive: line 49
Keep the input-to-feedback path free of artificial delays.
- Distinctive: line 50
Use pointer capture for drags so the interaction remains coherent outside the original bounds.
- Distinctive: line 61
Do not disable input merely because a transition is running.
- Distinctive: line 67
Start with critically damped motion for ordinary interface changes.
- Distinctive: line 68
Add overshoot only when the initiating action carries physical momentum or the overshoot communicates state.
- Distinctive: line 72
Read motion and gesture mechanics for formulas and implementation notes.
- Distinctive: line 77
Keep the source and destination visually related throughout the transition.
- Distinctive: line 78
Use depth, scrims, blur, and shadow to express hierarchy, not to decorate every surface.
- Distinctive: line 79
Avoid stacking translucent layers until text and controls lose stable contrast.
- Distinctive: line 87
Read materials, type, and accessibility for implementation constraints.
- Distinctive: line 91
Prefer compositor-friendly properties such as transforms and opacity for continuous motion.
- Distinctive: line 93
Prefer a motion library that exposes current values, velocity, cancellation, and retargeting for gesture-driven work.
- Distinctive: line 95
Do not claim native haptic support on platforms or browsers that do not provide it.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Fluid Interface Design
Build interfaces that respond immediately, preserve continuity, and remain controllable while they move. Treat motion as behavior produced by state and input, not decoration added after the interaction.
This is a platform-neutral design skill. It draws on public interaction-design research and platform guidance, but it does not ask for the visual imitation of any company or operating system.
Workflow
- Define the interaction contract.
- Name the user action, the state change it causes, and the recovery path.
- Decide whether motion communicates causality, hierarchy, spatial continuity, progress, or completion.
- Remove motion that serves none of those purposes.
- Trace the input path.
- Identify pointer, touch, keyboard, assistive-technology, and programmatic paths.
- Respond visually on press, not only after activation.
- For direct manipulation, update continuously and preserve the exact grab offset.
- Design continuity.
- Keep interactive motion interruptible and redirectable.
- Start a new transition from the current rendered value, not from a stale logical target.
- Use the same spatial path for entry and exit unless the change in path carries meaning.
- Choose motion behavior.
- Use an easing curve for a short, noninteractive state transition with a known duration.
- Use a spring when an object can be grabbed, redirected, or handed velocity.
- Use momentum projection before snapping when a flick should affect the destination.
- Use progressive resistance at boundaries instead of a hard visual stop.
- Design alternatives.
- Preserve feedback under reduced motion with short fades, color, or immediate state changes.
- Replace translucency when reduced transparency or increased contrast is requested.
- Keep every gesture available through another accessible input path.
- Verify in motion.
- Test interruption, reversal, rapid repeated input, slow drags, fast flicks, cancellation, and boundary cases.
- Inspect real frames or a recording; a nominal frame rate does not prove smooth visual motion.
- Test on representative low-power and high-refresh-rate devices.
Core Rules
Response
- Keep the input-to-feedback path free of artificial delays.
- Use pointer capture for drags so the interaction remains coherent outside the original bounds.
- Separate recognition thresholds from visible lag: a gesture may need hysteresis, but the interface should still acknowledge contact.
Direct manipulation
- Map drag distance to object movement one-to-one until the interaction reaches a meaningful constraint.
- Preserve where the user grabbed the object; do not jump its center under the pointer.
- Track a short timestamped position history so release velocity is stable rather than based on one noisy event.
Interruptibility
- Do not disable input merely because a transition is running.
- Retarget from the live presentation value and carry current velocity into the new motion.
- Model independent axes independently when their velocities or targets differ.
Springs and momentum
- Start with critically damped motion for ordinary interface changes.
- Add overshoot only when the initiating action carries physical momentum or the overshoot communicates state.
- Hand release velocity into the spring so the seam between gesture and animation is not visible.
- Project the likely resting point before selecting a snap target; do not choose only from the release position.
Read motion and gesture mechanics for formulas and implementation notes.
Space and hierarchy
- Anchor menus, popovers, and expanding surfaces to their trigger.
- Keep the source and destination visually related throughout the transition.
- Use depth, scrims, blur, and shadow to express hierarchy, not to decorate every surface.
- Avoid stacking translucent layers until text and controls lose stable contrast.
Typography and feedback
- Tune tracking and line height by text size; a single letter-spacing value is rarely correct across a type scale.
- Synchronize visual, audio, and haptic feedback to the same causal event.
- Reserve multimodal feedback for meaningful state changes so it remains informative.
Read materials, type, and accessibility for implementation constraints.
Implementation Boundary
- Prefer compositor-friendly properties such as transforms and opacity for continuous motion.
- Measure before introducing
will-change; persistent promotion can waste memory. - Prefer a motion library that exposes current values, velocity, cancellation, and retargeting for gesture-driven work.
- CSS transitions remain appropriate for simple noninteractive state changes.
- Do not claim native haptic support on platforms or browsers that do not provide it.
Review Checklist
- Feedback begins immediately and remains continuous.
- Direct manipulation preserves the grab point and tracks input accurately.
- Motion can be interrupted and reversed without jumps.
- Release velocity carries into the settling behavior.
- Entry and exit preserve spatial logic.
- Boundaries communicate resistance without appearing frozen.
- Keyboard and assistive-technology paths produce equivalent outcomes.
- Reduced motion, reduced transparency, and increased contrast have useful alternatives.
- Motion has been reviewed with real input and representative content, not only a scripted demo.
Sources and Attribution
This skill is a substantial rewrite derived from Emil Kowalski's apple-design skill, sourced from the emilkowalski/skills GitHub repository. Labor generalized the platform framing, rewrote the workflow, and split implementation detail into references; that modification does not erase the upstream origin.
The interaction principles also draw on public sources, including Apple's Designing Fluid Interfaces session and web-platform documentation. The upstream skill is MIT-licensed, Copyright (c) 2026 Emil Kowalski; its required notice is preserved in LICENSE. Product names and trademarks belong to their respective owners. Labor is not affiliated with or endorsed by Emil Kowalski or Apple.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

