gesture-patterns — Claude Code skill for gesture interactions
Designs touch and pointer gestures such as swipes, dragging and long presses. Use it when an interface relies on gestural input.
npx skills add Owl-Listener/designer-skills --skill gesture-patterns -a claude-codeWhat gesture-patterns does
This skill helps plan taps, double taps, long presses, swipes, pinches, rotation, dragging and pull-to-refresh. It maps each gesture to an action such as selection, navigation, dismissal, value adjustment or a context menu.
Its guidance covers visible affordances, first-use hints, immediate visual feedback, progress cues and completion confirmation. It suggests a 10-15px movement threshold and treats 500ms as a typical long-press threshold. It also addresses scroll-versus-swipe, tap-versus-long-press, and pinch-versus-drag conflicts.
Every gesture needs a button or menu alternative, and gesture animations should respect reduced-motion preferences. System gestures take priority, so check that the interface does not intercept back swipes or notification pulls. For standard iOS and Android gestures, the author directs you to platform-conventions in ui-design.
What it helps with
- design a swipe for navigation or dismissal
- separate scrolling from horizontal swipes
- add visible hints for hidden gestures
- set thresholds for dragging and long presses
- provide a button or menu alternative to a gesture
Example prompts for the agent
- Design gestures for a list where a swipe reveals actions without interfering with scrolling.
- Review card dragging for accessibility and add controls that do not require gestures.
- Suggest feedback and activation thresholds for pinch zoom on an image.
How to install gesture-patterns
1Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill gesture-patterns -a claude-code2Manually: put the files in place
~/.claude/skills/gesture-patterns/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/gesture-patterns/
1Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill gesture-patterns -a codex2Manually: put the files in place
.agents/skills/gesture-patterns/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill gesture-patterns -a cursor2Manually: put the files in place
.cursor/skills/gesture-patterns/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Owl-Listener/designer-skills gesture-patterns2Manually: put the files in place
.github/skills/gesture-patterns/SKILL.md1Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill gesture-patterns -a gemini-cli2Platform CLI
gemini skills install https://github.com/Owl-Listener/designer-skills --path interaction-design/skills/gesture-patternsManually: put the files in place
.devin/skills/gesture-patterns/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill gesture-patterns -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about gesture-patterns
How do I install gesture-patterns in Claude Code?
Run npx skills add Owl-Listener/designer-skills --skill gesture-patterns -a claude-code, then run npx skills add Owl-Listener/designer-skills --skill gesture-patterns -a claude-code again. The skill file is at ~/.claude/skills/gesture-patterns/SKILL.md.
What does gesture-patterns do?
It guides the design of touch and pointer gestures. The skill covers discoverability, feedback, activation thresholds, gesture conflicts and accessible alternatives.
How does gesture-patterns address accessibility?
Each gesture should have a button or menu alternative. The guidance also covers switch control, voice control, documenting custom gestures and reduced-motion preferences.
Source text
SKILL.md · MIT
--- name: gesture-patterns description: Design gesture interactions for touch and pointer — swipe, drag, long-press, and their discoverability. Use when input is gestural. For OS-standard gestures on iOS and Android, use `platform-conventions` (ui-design). --- # Gesture Patterns You are an expert in designing intuitive gesture-based interactions. ## What You Do You design gesture interactions that feel natural and discoverable across touch and pointer devices. ## Core Gestures - **Tap**: Select, activate, toggle - **Double tap**: Zoom, like/favorite - **Long press**: Context menu, reorder mode, preview - **Swipe**: Navigate, dismiss, reveal actions - **Pinch**: Zoom in/out - **Rotate**: Rotate content (maps, images) - **Drag**: Move, reorder, adjust values - **Pull**: Refresh content (pull-to-refresh) ## Gesture Design Rules ### Discoverability - Pair gestures with visible affordances - Provide visual hints on first use - Always have a non-gesture alternative (button/menu) ### Feedback - Immediate visual response when gesture starts - Progress indication during gesture - Threshold indicators (snap points, rubber-banding) - Completion confirmation ### Thresholds - Minimum distance before gesture activates (10-15px) - Velocity thresholds for flick/swipe - Direction lock (horizontal vs vertical) - Cancel zone (return to start to abort) ## Conflict Resolution - Scroll vs swipe: direction lock after initial movement - Tap vs long press: time threshold (500ms typical) - Pinch vs drag: number of touch points - System gestures take priority (back swipe, notification pull) ## Accessibility - Every gesture must have a non-gesture alternative - Support switch control and voice control - Custom gestures should be documented - Respect reduced-motion preferences for gesture animations ## Best Practices - Follow platform conventions - Keep gestures simple (one or two fingers) - Provide undo for destructive gesture actions - Test with one-handed use - Don't require precision timing
© Owl-Listener · MIT · Owl-Listener/designer-skills