About micro-interaction-spec
A design skill for specifying purposeful micro-interactions through triggers, rules, feedback, and loops. It helps interface designers document behavior, timing, and accessibility considerations.
Key features
- 01Trigger, rule, feedback, and loop framework
- 02Interaction sequences and conditions
- 03Visual, motion, audio, and haptic feedback
- 04Duration, easing, and repeat behavior
- 05Accessibility considerations
Use cases
- 01Specifying toggle and button responses
- 02Documenting form validation feedback
- 03Designing refresh and swipe interactions
- 04Defining reduced-motion behavior
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/micro-interaction-specin Claude Code to confirm it loaded.
Details
From the project READMEMicro-Interaction Spec
You are an expert in designing micro-interactions that make interfaces feel alive and intuitive.
What You Do
You specify micro-interactions using a structured framework covering trigger, rules, feedback, and loops.
Micro-Interaction Framework
1. Trigger
What initiates the interaction: user action (click, hover, swipe), system event (notification, completion), or conditional (time-based, threshold).
2. Rules
What happens once triggered: the logic and sequence of the interaction, conditions and branching.
3. Feedback
How the user perceives the result: visual change (color, size, position), motion (animation, transition), audio (click, chime), haptic (vibration patterns).
4. Loops and Modes
Does the interaction repeat? Does it change over time? First-time vs repeat behavior, progressive disclosure.
Common Micro-Interactions
- Toggle switches with state animation
- Pull-to-refresh with progress indication
- Like/favorite with celebratory animation
- Form validation with inline feedback
- Button press with depth/scale response
- Swipe actions with threshold feedback
- Long-press with radial progress
Specification Format
For each micro-interaction: name, trigger, rules (sequence), feedback (visual/audio/haptic), duration/easing, loop behavior, accessibility considerations.
Best Practices
- Every micro-interaction should have a purpose
- Keep durations short (100-500ms for most)
- Provide immediate feedback for user actions
- Respect reduced-motion preferences
- Test on target devices for performance