scenario-godot-audio
Use when adding or fixing sound in Godot 4.7: audio buses and effects, volume sliders, 'too many sounds', combat audio with hundreds of enemies, sounds clipping or distorting, 3D sound too quiet or not panning, reverb zones not working, occlusion, adaptive or interactive music (AudioStreamInteractiv…
Install / Use
npx skills add scenario-labs/skills --skill scenario-godot-audioInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
OtherSupported Platforms
Our assessment of scenario-godot-audio
scenario-godot-audio scores 86/100 on our quality scale, 197th of 354 Other skills we index.
Its SKILL.md is 19 KB long, well organised into 10 sections and no code examples: a thorough specification that gives an agent plenty to work with.
With 1,048 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated 35 days ago, so scenario-godot-audio is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands.
Automated pattern scan on 2026-11-20. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
scenario-godot-audio compared with similar skills
All 4 of these similar skills score higher than scenario-godot-audio; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| scenario-godot-audio (this skill)by scenario-labs | 86 | 1.0k | 35d ago | SKILL.md |
| LocalAIby mudler | 100 | 50.5k | today | MCP Server |
| algorithmic-artby anthropics | 100 | 177.9k | 2mo ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 2mo ago | SKILL.md |
| prospectingby coreyhaines31 | 100 | 60.1k | 11d ago | SKILL.md |
Frequently asked questions
- How do I install scenario-godot-audio?
- Run
npx skills add scenario-labs/skills --skill scenario-godot-audio. The install tabs above show the steps for each supported agent. - Which AI agents does scenario-godot-audio work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is scenario-godot-audio safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is scenario-godot-audio still maintained?
- The repository was last updated 35 days ago, so scenario-godot-audio is actively maintained.
Skill content
View source on GitHubname: scenario-godot-audio description: "Use when adding or fixing sound in Godot 4.7: audio buses and effects, volume sliders, 'too many sounds', combat audio with hundreds of enemies, sounds clipping or distorting, 3D sound too quiet or not panning, reverb zones not working, occlusion, adaptive or interactive music (AudioStreamInteractive, layers, stingers), music loops with gaps, SFX that repeat, AudioStreamRandomizer, AudioStreamGenerator, import settings, or importing AI-generated music, SFX and voice from Scenario or ElevenLabs." license: MIT
Godot audio (audio implementer)
Target: Godot 4.7.2.stable, macOS Apple Silicon.
At expert level, the mix is designed as data and then measured. Bus layouts, music transitions and
voice limits are written as specs. Every claim gets checked with numbers read from the mixer, since
an agent cannot listen. Experts spend more effort deciding which sounds not to play than on playing
them. That is the core of combat audio. If a sibling skill named here is missing from your available
skills, load it with skill_get (Scenario MCP) or ask the user to install it
(https://github.com/scenario-labs/skills#install); unattended, proceed from tool schemas and flag
the gap.
REQUIRED BACKGROUND: scenario-godot-expert (channels, gd_run, the review loop, 4.7 traps).
Status (2026-10-02): 18 live jobs in 12 test groups, the round-2 checks (P15) and 13 offline
tests all pass in Godot 4.7.2 (references/procedures.md,
tests/code/godot-audio/).
Stance (the expert delta)
- Measure headless; do not trust the "no sound" warning. The version deltas say
--headlessuses the Dummy driver and is silent. That is true for the speakers only. In 4.7.2 the Dummy driver still mixes in real time at 44.1 kHz. Peak meters,AudioEffectCaptureandAudioEffectRecordall work there, and a -24.08 dBFS file reads -24.07 (observed). For timing, render offline withAudioStreamPlayback.mix_audio()(audio_meter.render_stream), sample-exact; real-time recordings start about 0.2 s late (observed). - Good combat audio comes from not playing sounds. Somberg: "a lot of audio technology is about not playing sounds" (Vjm-- 00:05:20). Cap each sound type, keep about two plays within a radius, and cull by distance before spending a voice. Measured here with 200 enemies firing at 10 Hz: the naive mix peaks at +32.4 dBFS before the limiter, while a 32-voice pool with caps peaks at +8.5 (P6).
- Watch out for synchronous starts. With a hard cap and no cooldown, all 12 voices start on the same tick and end together. The mix then pulses in bursts (waveform sheet, P6). A per-type cooldown of 25 ms plus 4 randomized takes spreads them out, and the peak drops to -13.9 dBFS [added, measured].
- Write music as a transition table and audit every reachable pair. Octodemy builds the matrix
cell by cell (spBa 00:03:59). Bittmann wants every state change designed (dPXa 00:18:07). An
unlisted pair is not a hard cut. In 4.7.2 it waits for the next beat, then fades the source out
over about one beat (observed, P9).
music_builder.audit_interactivelists the missing pairs. - Put hold on the transition that leaves the clip you want to come back to. Docs and Octodemy describe "hold previous" plus return-to-hold (spBa 00:07:49). In 4.7.2 the return only works when hold is set on the earlier transition, the one that leaves the interrupted clip. With hold on the transition into the stinger, all 6 variants went silent after the stinger (observed, P9).
- Route everything through named buses, and reference them by name. Create Music and SFX buses
first (DevWorm 07Ky, Game Dev Artisan h3_1). A player whose bus is renamed reads back
"Master"and plays there. It recovers once the name is restored (observed). Audit scenes for players on Master or on missing buses (P13). - Measure spatial audio on the real curve. With 4.7.2 defaults (unit_size 10, max_db +3), a 3D
source is flat from 1 m to 7 m, drops 3 dB at 10 m and 21 dB at 80 m. A low-pass removes a
further 22 dB of 8 kHz at 20 m.
area_maskdefaults to 0, so Area3D reverb overrides do nothing until it is set to 1 (P7). - Condition generated audio before import, and verify it on the loaded resource. AI MP3s arrive hot (one test file: -8.4 LUFS, peak +0.99 dB) with silent padding. Normalize long files with two-pass loudnorm. Level short one-shots by peak, because loudnorm missed its target by 3 LU on a 0.5 s hit (observed, P4).
Establish first
| Input | Why it changes the plan | Default if not given |
| ------------------------------- | -------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
| Platform (desktop, mobile, web) | Web plays in Sample mode by default (default_playback_type.web = 1), which bypasses bus effects (docs) | desktop |
| 2D or 3D, listener | AudioStreamPlayer2D or 3D, unit size, max distance | 3D, Camera3D listener |
| Peak simultaneous sources | pool size, caps | 200 enemies, 32 voices |
| Music style (rhythmic, ambient) | bar or beat exits versus immediate, BPM import | rhythmic, 4/4 |
| Asset source | conditioning: AI (scenario-audio, scenario-elevenlabs) or a sound designer | AI files, conditioned |
| Middleware (FMOD, Wwise) | native nodes versus plugin banks | native Godot |
| Loudness targets | per-kind LUFS | -18 LUFS SFX, voice and music; -24 ambience [added] |
Workflow
- Buses as data (P1, P2). Build the layout from
audio_buses.COMBAT_LAYOUTwithbuild_layout, save it to the file named byaudio/buses/default_bus_layout, and reload it in a fresh process. GATE:audit_layoutreturns no flags, and the HardLimiter is on Master after the reload. A slider at 0.5 sets -6.02 dB, and the output drops 6.02 dB. - Import settings (P3). Edit
.importkeys withgd_audio.set_import_params, rungd_run.import_project, then read the loaded resource. GATE: music hasloop,bpmandbeat_countset on the loaded stream, andgd_audio.audit_importsreturns no flags. - Generated assets (P4).
prepare_ai_audio(src, dst, kind)trims silence, levels the file and converts SFX to mono WAV.bars_for(seconds, bpm)givesbeat_count. GATE: a loudness spread under 1 LU per kind, no lead silence, and a loop seam with a lag of 0 samples fromaudio_meter.loop_seam(stream). - SFX variation (P5). Use AudioStreamRandomizer with 3 or more takes, pitch in semitones and a volume offset. GATE: no repeats over 24 plays, all takes used, and the measured pitch within the set range.
- Voices (P6). Use
SfxPoolwith per-typelimit,radius_m,radius_limit,cooldown_ms,max_distance_mand priority stealing. GATE: on the 200-enemy burst, live voices stay within the cap, the node count stays flat, and the peak before the limiter is under 0 dBFS. Then open the waveform sheet and look at it. - Space (P7, P8, P15). Listener first: in 3D with no current Camera3D or AudioListener3D, every
3D player is silent (-200 dB).
AudioListener3D.make_current()overrides the camera (moved 40 m off: -12.1 to -29.8 dB, sides swapped). In 2D without a listener the viewport center hears: put anAudioListener2Don the player (DevWorm 07Ky 00:33:25, First Pancake 1PDU 00:04:05). Then unit_size, max_distance,area_mask = 1for room buses, and occlusion (one ray at play time for shots,Occluder3Dfor long emitters). GATE: one current listener; every positional player on a named non-Master bus (audio_audit.scan); measured levels per distance, left/right balance, and an 8 kHz drop of 12 dB or more when blocked. - Music (P9). Build the interactive stream with
music_builder.build_interactive(spec), audit it and save it as.tres. Use AudioStreamSynchronized stems for layers. GATE: a tone-tracked offline render shows each switch on its bar or beat, and the stinger returns to the held clip. - Mix states keyed on game state (P2, P15). Just Cause 4 mutes ambience above 5 engaged enemies
and moves the combat mix in about 1 s (uN8R 00:19:07 to 00:21:12). Write the state as a function
of the game, not of the audio:
GATE: for 0, 3 and 8 engaged, each bus reaches its target within the fade (measured exact at 0.25 s). Do not toggle buses by hand for silence: Godot disables a silent bus after a few seconds by itself (audio buses doc).static func combat_mix(engaged: int) -> Dictionary: if engaged == 0: return {"Ambience": -6.0, "Music": -8.0} if engaged <= 5: return {"Ambience": -12.0, "Music": -6.0} return {"Ambience": -80.0, "Music": -4.0} # on change: audio_buses.apply_state(self, combat_mix(n), 1.0) - Render the mix (P12). Run Movie Maker with
--write-movie x.avi --fixed-fps 60(windowed, 160x90), thengd_audio.movie_audio. GATE: 48 kHz output, two seeded renders with identical MD5, integrated loudness inside the target, a true peak under -1 dBTP, and a spectrogram that you open.
Numbers
| Value | Measured or source | Relative to | | ------------------------------ | --------------------------------------------------------------------------------- | -------------------------------------------------------- | | 3D level, flat region | 1 to 7 m at 0 dB, -3 dB at 10 m, -8.9 at 20, -14.8 at 40, -20.7 at 80 (500 Hz) | inverse model, unit_size 10, max_db +3 | | Distance low-pass | none at 10 m; 8 kHz a further -22 dB at 20 m, -29 at 40 m | defaults 5000 Hz, filter_db -24; filter_db 0 disables it | | Pan, 5 m to the right | L -16.0 / R -10.0 dB | panning_strength 1.0 times project 3d 0.5 | | Linear slider | 0.5 is -6.02 dB; mute under 0.05 | Game Dev Artisan (h3_1 00:09:23) | | Pool | 32 voices, ring of players | Michael Games (H-6p 00:09:44) | | Radius rule | keep about 2 plays per radius | Somberg (00:05:52), Murch's "rule of two and a half" | | Combat peak before the limiter | naive +32.4, pooled +8.5, tuned -13.9 dBFS | 200 enemies, 10 Hz, 2 s (P6) | | Occlusion | 8 kHz -58 dB through a 1 kHz low-pass; Occluder3D 20 kHz to 800 Hz in about 0.5 s | P8 | | Loudness targets | -18 LUFS SFX, voice, music; -24 ambience; true peak -1 dBTP | [added] starting points
Truncated for display — read the full file on GitHub.
Related Skills
LocalAI
50.5kLocalAI is the open-source AI engine. Run any model - LLMs, vision, voice, image, video - on any hardware. No GPU required.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
prospecting
60.1kWhen the user wants to find and qualify prospects for outbound, or asks who to target first, which signal to prioritize, or where to spot buyers with the problem: buying signals, enrichment, verification, account research.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
