Skip to content
SkillModel-led1,921 tokens in use

godot-audio

Plays, routes and controls sound in Godot 4.7 with AudioStreamPlayer nodes, buses and AudioServer, and checks bus names with a headless script.

9,684 stars on the repository Apache License 2.0gamedev-skills/awesome-gamedev-agent-skills · skills/godot/godot-audio
npx skills add gamedev-skills/awesome-gamedev-agent-skills
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing godot-audio costs

93tokens idle
1,921tokens in use
3,003tokens, up to

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Up to adds the files its instructions link. Counts are approximate, made offline with cl100k_base.

Model dependence Model-led

Script-ledMixedModel-led

Mostly instructions, so how well it works depends on the model that follows them.

This describes the skill's structure, how much of it is scripts. It does not say how well it works.

Touches

shelldetected

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Excellent
  • Frontmatter12/15
  • Structure25/25
  • Examples15/15
  • Output15/15
  • Size13/15
  • Resources15/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Excellent
  • File that was not read−15

    a file the skill ships that was not read, so what it does is unknown

    assets/check_audio_buses.gd

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Good
  • Development activity92
  • Maintenance96
  • Community60
  • Maturity24
  • Momentum40

This skill covers Godot 4.7 audio from the node level to the mixer: AudioStreamPlayer, AudioStreamPlayer2D and 3D, the bus layout file, AudioServer volume and mute, polyphony, looping imports and playback position for beat sync. It starts by reading the project’s bus layout so names in scenes and code match exactly.

It includes patterns for overlapping one-shot effects, a mute-aware volume slider, a two-player music crossfade and song time for rhythm games. A bundled headless check reports every bus name that the layout does not define, with file and line.

What You Get

  • A workflow that reads the bus layout, picks a player node, routes buses, sets volume and sets loops at import
  • GDScript patterns for overlapping SFX, a bus volume slider with mute, a music crossfade and beat-sync song time
  • A headless bus check that lists every bus name the layout does not define, with file and line
  • A gotcha list for silent sounds, cut-off effects, missing loops, silent 3D audio and web export effects

Common Use Cases

  • Adding sound effects and music with separate volume sliders
  • Debugging a sound that plays on Master and ignores its bus
  • Syncing gameplay to a song with a corrected playback position
  • Fixing effects or reverb that go silent only in a web export

What Makes It Unique

Godot falls back to the Master bus without an error when a bus name is wrong, so the mistake stays hidden. This skill ships a headless check that loads the real layout and reports every bad name. It also records version-specific traps such as the 4.7 area_mask default and the Web Audio sample playback in web exports.

Under The Hood

The agent loads the SKILL.md and, when needed, a reference on the layout file, the AudioServer API, effects and positional audio. It runs commands in your project: the Godot binary headless with the bundled GDScript bus check, and optionally the Python project checker from the godot-nodes-scenes skill to find missing stream files. It reads project, scene and script files and makes no network calls. The shipped GDScript check is a file type the scanner cannot read, so what it does was not analysed and is worth a look before you run it. Loudness and mix still need a person to listen.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers