rshankras/game-feel
Game feel ("juice") for Apple apps — celebration choreography, haptic vocabulary design, sound-effect layers, and the event×channel feedback audit. Use when big moments fall flat, when designing haptics or SFX, or when auditing whether every meaningful event actually reaches the user.
npx skills add https://github.com/rshankras/claude-code-apple-skills --skill game-feel
Makes an app's meaningful moments *land* — through coordinated motion, haptics, and sound. Animation technique lives in design/animation-patterns; confetti/badge generation lives in generators/milestone-celebration. This skill is the discipline layer: which events deserve feedback, on which channels, and how to verify nothing important is silent.
Use this skill when the user:
.sensoryFeedback)| Channel | Who perceives it |
|---------|------------------|
| Haptics | Only the person holding the device |
| Screen motion | Whoever is looking at the screen |
| Audio | The whole room |
| Torch / flash | The whole room, even in noise |
A single-user utility can lean on haptics. A shared-phone or room-facing app (party games, kitchen timers, presentations) must put its signature moments on a room-scale channel. The most common juice failure: all feedback is haptic, and the phone is lying on a table.
Tick < action confirmed < success < round complete < winner. If the rarest event (winning) fires the same pattern as a routine one (round end), the app has no climax. Reserve the biggest pattern, the confetti burst, and the fanfare for the rarest event.
If the timer's ring turns amber at 10s and red at 5s, the haptic tier and any audio tick must escalate at the *same* thresholds. Cross-channel disagreement reads as broken, not layered.
Exactly one code layer fires feedback for a given event. When an engine *and* a view-store both react to "music stopped", the user gets a double-buzz. Decide the owner (usually the layer closest to the state machine) and make the other layer silent.
Every effect must be attached to an event the user cares about. Ambient/always-on effects (background particles, looping glows) are *texture*, not feedback — keep them static or slow, and never let them compete with event feedback.
What do you need?
│
├─ Which events should have feedback, and on which channels?
│ └─ → feedback-audit.md (event×channel matrix + three-lens audit)
│
├─ Design or review haptics (vocabulary, service architecture, APIs)
│ └─ → haptic-design.md
│
├─ Add a sound-effect layer (assets, latency, AVAudioSession coexistence)
│ └─ → sound-design.md
│
├─ HOW to animate a celebration/transition you've already decided on
│ └─ → design/animation-patterns (springs, transitions, symbol effects)
│
├─ Generate confetti / badge / milestone UI code
│ └─ → generators/milestone-celebration
│
└─ Animated SF Symbols for feedback moments
└─ → design/sf-symbols (preset vocabulary)
When reviewing an app's game feel, verify:
.contentTransition(.numericText())) — values never teleport| File | Content |
|------|---------|
| feedback-audit.md | Event×channel matrix method, three-lens audit (runnable subagent prompts), scoring rubric, output format |
| haptic-design.md | API decision table, semantic-vocabulary service architecture, pattern design rules, lifecycle, pitfalls |
| sound-design.md | Minimal SFX kit, asset formats and latency, AVAudioSession coexistence with music, silent-switch policy, pitfalls |
design/animation-patterns — the *how* of every motion techniquedesign/sf-symbols — symbol effect vocabulary for feedback glyphsgenerators/milestone-celebration — production confetti/badge/celebration codeios/accessibility-audit — Reduce Motion and assistive-tech verificationTake rshankras/game-feel from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.