gamedev-core/skills/game-development/game-audio/SKILL.md
Game audio principles. Sound design, music integration, adaptive audio systems.
npx skillsauth add bernatmv/ai-rules game-audioInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Sound design and music integration for immersive game experiences.
| Category | Behavior | Examples | |----------|----------|----------| | Music | Looping, crossfade, ducking | BGM, combat music | | SFX | One-shot, 3D positioned | Footsteps, impacts | | Ambient | Looping, background layer | Wind, crowd, forest | | UI | Immediate, non-3D | Button clicks, notifications | | Voice | Priority, ducking trigger | Dialogue, announcer |
When sounds compete for channels:
1. Voice (highest - always audible)
2. Player SFX (feedback critical)
3. Enemy SFX (gameplay important)
4. Music (mood, but duckable)
5. Ambient (lowest - can drop)
| Approach | When to Use | Trade-offs | |----------|-------------|------------| | Recording | Realistic needs | High quality, time intensive | | Synthesis | Sci-fi, retro, UI | Unique, requires skill | | Library samples | Fast production | Common sounds, licensing | | Layering | Complex sounds | Best results, more work |
| Layer | Purpose | Example: Gunshot | |-------|---------|------------------| | Attack | Initial transient | Click, snap | | Body | Main character | Boom, blast | | Tail | Decay, room | Reverb, echo | | Sweetener | Special sauce | Shell casing, mechanical |
Game State → Music Response
│
├── Menu → Calm, loopable theme
├── Exploration → Ambient, atmospheric
├── Combat detected → Transition to tension
├── Combat engaged → Full battle music
├── Victory → Stinger + calm transition
├── Defeat → Somber stinger
└── Boss → Unique, multi-phase track
| Technique | Use When | Feel | |-----------|----------|------| | Crossfade | Smooth mood shift | Gradual | | Stinger | Immediate event | Dramatic | | Stem mixing | Dynamic intensity | Seamless | | Beat-synced | Rhythmic gameplay | Musical | | Queue point | Next natural break | Clean |
| Parameter | Affects | Example | |-----------|---------|---------| | Threat level | Music intensity | Enemy count | | Health | Filter, reverb | Low health = muffled | | Speed | Tempo, energy | Racing speed | | Environment | Reverb, EQ | Cave vs outdoor | | Time of day | Mood, volume | Night = quieter |
| System | What Changes | Best For | |--------|--------------|----------| | Vertical (layers) | Add/remove instrument layers | Intensity scaling | | Horizontal (segments) | Different music sections | State changes | | Combined | Both | AAA adaptive scores |
| Element | 3D Positioned? | Reason | |---------|----------------|--------| | Player footsteps | No (or subtle) | Always audible | | Enemy footsteps | Yes | Directional awareness | | Gunfire | Yes | Combat awareness | | Music | No | Mood, non-diegetic | | Ambient zone | Yes (area) | Environmental | | UI sounds | No | Interface feedback |
| Distance | Sound Behavior | |----------|----------------| | Near | Full volume, full frequency | | Medium | Volume falloff, high-freq rolloff | | Far | Low volume, low-pass filter | | Max | Silent or ambient hint |
| Platform | Recommended Format | Reason | |----------|-------------------|--------| | PC | OGG Vorbis, WAV | Quality, no licensing | | Console | Platform-specific | Certification | | Mobile | MP3, AAC | Size, compatibility | | Web | WebM/Opus, MP3 fallback | Browser support |
| Game Type | Audio Budget | Strategy | |-----------|--------------|----------| | Mobile casual | 10-50 MB | Compressed, fewer variants | | PC indie | 100-500 MB | Quality focus | | AAA | 1+ GB | Full quality, many variants |
| Category | Relative Level | Notes | |----------|----------------|-------| | Voice | 0 dB (reference) | Always clear | | Player SFX | -3 to -6 dB | Prominent but not harsh | | Music | -6 to -12 dB | Foundation, ducks for voice | | Enemy SFX | -6 to -9 dB | Important but not dominant | | Ambient | -12 to -18 dB | Subtle background |
| When | Duck What | Amount | |------|-----------|--------| | Voice plays | Music, Ambient | -6 to -9 dB | | Explosion | All except explosion | Brief duck | | Menu open | Gameplay audio | -3 to -6 dB |
| Don't | Do | |-------|-----| | Play same sound repeatedly | Use variations (3-5 per sound) | | Max volume everything | Use proper mix hierarchy | | Ignore silence | Silence creates contrast | | One music track loops forever | Provide variety, transitions | | Skip audio in prototype | Placeholder audio matters |
Remember: 50% of the game experience is audio. A muted game loses half its soul.
This skill is applicable to execute the workflow or actions described in the overview.
development
Keyword research and validation with real search-demand data — never ship keywords from intuition alone. Probes Google Autocomplete per language (free, no account) to prove demand and discover the exact phrasing people type, checks SERPs for winnability, and uses Keyword Planner/Ahrefs/Semrush exports when the user has access. Activates when: choosing or reviewing SEO keywords, meta keywords, page titles, article topics or slugs, landing page copy targeting search, App Store/ASO keyword fields, multilingual keyword sets, 'what should we rank for', 'keyword analysis', or auditing why a page doesn't rank. Also invoke it as a validation pass whenever another skill or task produces a keyword list.
development
Automate YooAsset hot-update and asset bundles — build bundles, run Editor simulate builds, manage Collector groups, analyze BuildReport, and validate runtime. Use when building or simulating YooAsset bundles, configuring collectors, or validating hot-update assets, even if the user just says "热更" or "打AB包". 自动化 YooAsset 热更新与资源包(构建 bundle、编辑器模拟构建、管理 Collector 分组、分析 BuildReport、运行时校验);当用户要构建或模拟 YooAsset 资源包、配置 collector、或校验热更资源时使用。
development
Source-anchored design rules for YooAsset v2.3.18 — initialization, default-package shortcuts, play modes, asset handles, loading, updates, filesystem, build, and pitfalls. Use when writing or reviewing YooAsset code, initializing packages, loading assets via handles, setting up hot-update/download, or choosing a play mode, even if the user just says "热更" or "资源包". 为 YooAsset v2.3.18 提供源码锚定的设计规则(初始化、默认包快捷方式、运行模式、资源句柄、加载、更新、文件系统、构建、陷阱);当用户要编写或审查 YooAsset 代码、初始化 package、用句柄加载资源、配置热更/下载、或选择运行模式时使用。
data-ai
Last-resort guidance for safely hand-editing Unity serialized YAML (.unity/.prefab/.asset/.meta/ProjectSettings) — reference/fileID repair, GUID safety, and merge-conflict fixes. Use when REST cannot reach the change and YAML must be hand-edited — fixing m_Script GUIDs, broken fileID references, .meta files, or merge conflicts, even if the user just says "场景文件打不开" or "引用丢了". 安全手编 Unity 序列化 YAML(.unity/.prefab/.asset/.meta/ProjectSettings)的最后手段(引用/fileID 修复、GUID 安全、合并冲突修复);当 REST 无法触达、必须手编 YAML 时使用——修复 m_Script GUID、断裂 fileID 引用、.meta 文件或合并冲突。