audio-design
Use when designing how audio communicates game state, creates emotion, and serves as a feedback system. Activate for sound effect design, adaptive music systems, spatial audio, ambient soundscapes, audio priority and ducking, emotional audio design, and audio accessibility. Also activate when audio feels disconnected from gameplay, when players routinely play on mute (a design failure signal), when evaluating whether the audio stack has appropriate layering and variation, or when planning how music responds to gameplay context. This skill treats audio as a design system — not audio engineering or production, but the intentional design of what players hear, when, and why. Covers the full audio stack from music and ambience through sound effects, UI audio, and voice.
What this skill does
# Audio Design
Audio is the fastest feedback channel in a game. Players process sound faster than
visual information — audio tells them what is happening before they see it, behind
them, and outside their field of view. A game where players mute the audio and lose
nothing has failed at audio design.
This skill covers audio as a **design system**: deciding what sounds exist, when they
play, how they relate to gameplay state, and how they serve the player's understanding
of the game world. Production concerns (recording, mastering, compression formats) are
out of scope.
---
## When to Activate
- Designing sound effects for player actions, enemies, or environment
- Building adaptive music systems that respond to gameplay
- Planning spatial audio for directional awareness and immersion
- Creating ambient soundscapes that establish atmosphere
- Diagnosing why audio feels disconnected from gameplay
- Noticing that players routinely play on mute
- Adding audio accessibility features
- Evaluating audio feedback coverage across game systems
- Balancing the audio mix and priority system
---
## Core Principle: Audio as Information System
Sound is not decoration — it is an information channel that operates independently from
the visual field. Design audio with the same rigor applied to any other game system.
**What audio communicates that visuals cannot:**
| Advantage | Example |
|---|---|
| 360-degree awareness | Footsteps behind the player |
| Off-screen events | Explosion around a corner |
| Anticipation/warning | Audio wind-up before an attack lands |
| Emotional context | Minor-key shift signaling danger |
| Confirmation | Satisfying click confirming a successful action |
| Pacing | Tempo change signaling urgency |
**The mute test:** If a player can play the game on mute with no loss of information or
enjoyment, the audio design is not carrying its weight. Every audio element should either
convey information, create emotion, or both. Purely decorative audio that does neither is
wasted bandwidth in the mix.
---
## The Audio Stack
Audio architecture uses independent layers, each serving a distinct purpose. Every layer
must be independently controllable — players need per-layer volume sliders, not just a
master volume knob.
### Layer 1: Music
**Purpose:** Emotional context, tension management, pacing.
Music tells the player how to *feel* about what is happening. It operates on slower
timescales than other audio — setting mood across minutes rather than reacting frame by
frame.
- Establishes emotional tone for areas, encounters, and story beats
- Manages tension arcs (build, sustain, release)
- Creates anticipation for events that have not happened yet
- Signals safety or danger before the player has evidence
### Layer 2: Ambience
**Purpose:** Spatial context, atmosphere, world presence.
Ambience is the audio foundation that makes a space feel real. Without it, environments
feel sterile regardless of visual quality.
- Area-specific ambient beds (forest, cave, city, dungeon)
- Time-of-day variation (dawn chorus, night insects)
- Weather audio (rain, wind, thunder)
- Incidental environmental sounds (distant bird, creaking wood)
### Layer 3: Sound Effects
**Purpose:** Game state feedback, player action confirmation.
Sound effects are the primary feedback channel for moment-to-moment gameplay. They confirm
actions, communicate results, and signal state changes.
- Player action sounds (attack, jump, dash, interact)
- Impact and result sounds (hit, miss, block, break)
- Enemy feedback (telegraph, attack, damage, death)
- Environmental interaction (doors, switches, pickups)
### Layer 4: UI Audio
**Purpose:** Interface feedback, notifications, system communication.
UI audio confirms interface actions and draws attention to important system events. It
should be clean, consistent, and never fatiguing.
- Menu navigation (hover, select, back, error)
- HUD notifications (low health, buff applied, cooldown ready)
- Achievement and progression sounds
- Inventory and crafting feedback
### Layer 5: Voice
**Purpose:** Dialogue, barks, callouts, narrative delivery.
Voice is the most attention-demanding audio layer. When voice plays, everything else
should defer.
- Story dialogue and cutscene speech
- Companion/NPC barks (contextual one-liners)
- Combat callouts (enemy spotted, low ammo, revive request)
- Tutorial and hint voiceover
---
## Sound Effect Design
Every significant player action needs an audio response. Missing audio feedback creates
a disconnect that players feel even if they cannot articulate it.
### Feedback Principles
**Match visual weight.** A massive explosion with a thin pop sound creates cognitive
dissonance. A small UI toggle with a booming thud feels wrong. Audio and visual weight
must be proportional.
**Immediate onset.** Audio feedback should begin within 1–2 frames of the corresponding
visual onset. The perception-action cycle depends on audio and visual alignment — see
**game-feel** for timing reference tables. Late audio feels sluggish; early audio feels
disconnected.
**Priority ordering:**
| Priority | Category | Rationale |
|---|---|---|
| 1 | Player actions | The player must hear confirmation of their own inputs |
| 2 | Enemy feedback | Threats need clear audio communication |
| 3 | Environment | World interaction supports immersion |
| 4 | Ambience | Atmosphere fills gaps but yields to gameplay |
### Variation
Any sound that plays more than twice within a 10-second window needs at minimum 3
variants. Repetition fatigue is one of the fastest ways to make audio annoying.
**Variation techniques:**
- **Pitch randomization:** ±5–15% pitch shift on each play (cheap, effective)
- **Alternate clips:** 3–5 recorded or synthesized variants, round-robin or random
- **Layered randomization:** Randomize individual layers of a composite sound
- **Velocity scaling:** Vary volume and EQ based on action intensity
### Layering Complex Sounds
Complex actions deserve composite audio built from multiple layers:
```
Sword hit = impact layer + material layer + environment layer
= [metal clang] + [flesh thud] + [room reverb tail]
```
Each layer can be swapped independently — the same impact with a different material
layer communicates hitting stone vs. wood vs. armor.
---
## Adaptive Music System
Static music that ignores gameplay state is a missed opportunity. Music should respond
to what the player is experiencing.
### Music States
Define discrete music states tied to gameplay context:
| State | Character | Typical Triggers |
|---|---|---|
| Exploration | Calm, open, melodic | No threats, traversal, discovery |
| Tension | Building, uneasy, rhythmic | Threat proximity, low resources, time pressure |
| Combat | Intense, driving, percussive | Active combat engagement |
| Resolution | Release, exhale, thinning layers | Combat end, threat eliminated |
| Victory | Triumphant, ascending, major key | Boss defeat, objective complete |
| Defeat | Somber, descending, sparse | Player death, mission failure |
### Transition Techniques
| Technique | Description | Best For |
|---|---|---|
| Crossfade | Blend out current, blend in next | Gradual mood shifts |
| Stinger-to-track | Short musical hit bridges to new track | Sudden state changes |
| Horizontal re-sequencing | Same tempo, swap musical layers | Intensity changes within a state |
| Vertical layering | Add/remove instrument layers | Smooth intensity scaling |
### Intensity Layers
The most flexible adaptive music approach uses vertical layering:
- **Base layer** always plays (establishes key, tempo, harmonic foundation)
- **Layer 2** adds rhythmic drive (percussion, bass patterns)
- **Layer 3** adds melodic tension (strings, synth leads)
- **Layer 4** adds full intensity (full orchestra, heavy percussion)
Layers add or remove based on a gameplay intensity value (0.0–1.0). This produces
smooth, musically coherent transitions because all layers share tempoRelated in Design
contribute
IncludedLocal-only OSS contribution command center. Auto-refreshes the user's in-flight PR and issue state on invoke so conversations start with full context — no need to brief Claude on what's in flight. Helps the user find issues to contribute to on GitHub, builds per-repo dossiers of what each upstream expects (CLA, DCO, branch convention, AI policy, draft-first, review bots, issue templates), runs deterministic gates before any external action so AI-assisted contributions don't reach maintainers as slop. State is markdown-only: candidate files at ~/.contribute-system/candidates/, repo dossiers at ~/.contribute-system/research/, append-only event log at ~/.contribute-system/log.jsonl. No database, no cloud calls. Use when the user asks about their PRs / issues / contributions, wants to find new work to take on, claim an issue, build/refresh a repo's dossier, or draft a Design Issue or PR. Trigger with "/contribute", "what's my PR status", "find a contribution", "claim issue X", "draft a Design Issue for Y", "refresh dossier for Z".
architectural-analysis
IncludedUser-triggered deep architectural analysis of a codebase or scoped subtree across eight modes — information architecture, data flow, integration points, UI surfaces, interaction patterns, data model, control flow, and failure modes. This skill should be used when the user asks to "diagram this codebase," "map the architecture," "show the data flow," "give me an ERD," "trace control flow," "find the integration points," "verify the layout pattern," "audit the UX architecture," or any similar request whose primary deliverable is mermaid diagrams plus cited reports under docs/architecture/. Dispatches haiku/sonnet sub-agents in parallel for per-mode exploration, then verifies every citation mechanically before any node lands in a diagram. Not for one-off prose explanations of code (use code-explanation) or for high-level system design from scratch (use system-design).
mcp
IncludedModel Context Protocol (MCP) server development and tool management. Languages: Python, TypeScript. Capabilities: build MCP servers, integrate external APIs, discover/execute MCP tools, manage multi-server configs, design agent-centric tools. Actions: create, build, integrate, discover, execute, configure MCP servers/tools. Keywords: MCP, Model Context Protocol, MCP server, MCP tool, stdio transport, SSE transport, tool discovery, resource provider, prompt template, external API integration, Gemini CLI MCP, Claude MCP, agent tools, tool execution, server config. Use when: building MCP servers, integrating external APIs as MCP tools, discovering available MCP tools, executing MCP capabilities, configuring multi-server setups, designing tools for AI agents.
react-native-skia
IncludedDesign, build, debug, and optimise high-polish animated graphics in React Native or Expo using @shopify/react-native-skia, Reanimated, and Gesture Handler. Use when the user wants canvas-driven UI, shaders, paths, rich text, image filters, sprite fields, Skottie, video frames, snapshots, web CanvasKit setup, or performance tuning for custom motion-heavy elements such as loaders, hero art, cards, charts, progress indicators, particle systems, or gesture-driven surfaces. Also use when the user asks for fluid, glow, glass, blob, parallax, 60fps/120fps, or GPU-friendly animated effects in React Native, even if they do not explicitly say "Skia". Do not use for ordinary form/layout work with standard views.
plaid
IncludedProduct Led AI Development — guides founders from idea to launched product. Six capabilities: Idea (discover a product idea), Validate (pressure-test the idea against fatal flaws, problem reality, competition, and 2-week MVP feasibility), Plan (vision intake + document generation), Design (translate image references into a design.md spec), Launch (go-to-market strategy), and Build (roadmap execution). Use when someone says "PLAID", "plaid idea", "help me find an idea", "product idea", "idea from my business", "idea from my expertise", "plaid validate", "validate my idea", "pressure-test", "is this idea good", "find fatal flaws", "validate the problem", "plan a product", "define my vision", "generate a PRD", "product strategy", "plaid design", "design from image", "translate image to design", "create design.md", "extract design tokens", "plaid launch", "go-to-market", "launch plan", "GTM strategy", "launch playbook", "plaid build", "build the app", "start building", or "execute the roadmap".
nextjs-framer-motion-animations
IncludedAdds production-safe Motion for React or Framer Motion animations to Next.js apps, including reveal, hover and tap micro-interactions, whileInView, stagger, AnimatePresence, layout and layoutId transitions, reorder, scroll-linked UI, and lightweight route-content transitions. Use when the user asks to add, refactor, or debug Motion or Framer Motion in App Router or Pages Router codebases, especially around server/client boundaries, reduced motion, LazyMotion, bundle size, hydration, or route transitions. Avoid for GSAP-style timelines, WebGL or 3D scenes, heavy scroll storytelling, or CSS-only effects unless Motion is explicitly requested.