About micro-interaction-spec
micro-interaction-spec is a design skill for describing interface micro-interactions in a consistent format. It organizes each interaction around its trigger, rules, feedback, loops, timing, and accessibility.
Key features
- 01Trigger, rules, and feedback framework
- 02Loop and mode definitions
- 03Structured interaction specifications
- 04Duration and easing guidance
- 05Accessibility and device testing
Use cases
- 01Specifying a toggle or form validation response
- 02Designing swipe or long-press feedback
- 03Documenting interaction timing and accessibility
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