跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
视频与音频

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 · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

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

技能说明


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