Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Video & audio

audio-to-ogg

Converts a single audio file to OGG Vorbis using FFmpeg for Godot-ready compressed assets. Use when the user wants to convert audio to OGG, transcode WAV/MP3/FLAC/AAC to OGG, export a Godot-ready OGG asset, or mentions Vorbis, libvorbis, or Godot audio import.

godot-fun · Static checks on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add godot-fun/godot-agent --skill audio-to-ogg

About this skill


name: audio-to-ogg description: Converts a single audio file to OGG Vorbis using FFmpeg for Godot-ready compressed assets. Use when the user wants to convert audio to OGG, transcode WAV/MP3/FLAC/AAC to OGG, export a Godot-ready OGG asset, or mentions Vorbis, libvorbis, or Godot audio import.

Audio to OGG

Convert a supported audio file to OGG Vorbis via FFmpeg. Defaults preserve source sample rate and encode at Vorbis quality 10 (maximum) for minimal generation loss.

Rules

When this skill applies, read and follow skill-dependency-manager — run scripts as documented, install missing tools into .dependency/.

Quick Start

Default output: <audio-dir>/audio-to-ogg/<basename>.ogg

.dependency/python/python .ai/audio-to-ogg/convert.py --audio path/to/audio.wav

Example: audio/sfx/tank/tank_move.wav → audio/sfx/tank/audio-to-ogg/tank_move.ogg

Format Defaults

SettingDefaultNotes
CodecOGG Vorbis (libvorbis)Godot-native compressed format
Sample ratePreserve sourceAlways keeps source rate; no resampling
Quality10 (-q 10)Maximum Vorbis quality (~500 kbps VBR); use lower -q to shrink files
ChannelsPreserve sourceUse --mono or --stereo to force
Existing Vorbis OGGStream copyBit-perfect when no overrides

Quality Guide

-qApprox. bitrateTypical use
10~500 kbpsDefault — highest fidelity
7–8~224–256 kbpsSmaller music/voice exports
5–6~160–192 kbpsGameplay SFX, BGM
3–4~96–128 kbpsShort UI clicks, ambient loops

Common Flags

--audio · -o / --output · -q / --quality · --mono · --stereo

Lower quality for UI sounds:

.dependency/python/python .ai/audio-to-ogg/convert.py --audio path/to/click.wav -q 4

Custom output path:

.dependency/python/python .ai/audio-to-ogg/convert.py --audio path/to/audio.wav --output path/to/out.ogg

Never overwrite source files. The script writes only under audio-to-ogg/ (or --output). Input must be a single audio file (--audio), not a directory. Supported inputs: .mp3, .ogg, .flac, .aac, .m4a, .wma, .wav.

Agent Notes

  1. Use the bundled script, not hand-written ffmpeg -i … commands.
  2. Sample rate is always preserved — use the audio-sample-rate-standardize skill if resampling is needed.
  3. Already Vorbis OGG? Stream-copied by default (no generation loss).
  4. Missing Python/FFmpeg → populate .dependency/ per skill-dependency-manager, retry same command.
  5. Do not copy, move, or replace the source with converted output — tell the user where output files are; they swap assets manually when ready.
  6. FFmpeg codec and quality details: reference.md

Tests

From repo root:

.dependency/python/python .ai/audio-to-ogg/test_convert.py

Manual CLI examples: cli/audio-to-ogg.md