# console-sound

Console-sound is a Claude Code skill that rips game audio and injects custom tracks back into the files. It decodes PS2 VAG and SPU2 ADPCM formats into WAV for easy editing.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 449 repo stars
- Author: Jake Schincariol
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/Jakeschincariol/console-skill/tree/HEAD/console-sound/SKILL.md
- Updated: 2026-10-22
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/console-sound

## What it does

The tool converts audio assets to WAV format for review and encodes 16-bit WAV files back to VAG, maintaining original sample rates, loop points, and size. All output files are generated in the `console/audio/` directory.

It requires Python 3 to run. The skill scans archives for hidden audio, splits sound banks, and verifies headers. To ensure game stability, it refuses to replace sounds with files larger than the original unless specific flags are provided, preventing overflow in the SPU2 sound memory.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add Jakeschincariol/console-skill
```
In the agent chat (not a shell):
```text
/plugin install console-skill@console-skill
```
This installs the whole console-skill plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add Jakeschincariol/console-skill --skill console-sound -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/console-sound/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/console-sound/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Jakeschincariol/console-skill --skill console-sound -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/console-sound/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Jakeschincariol/console-skill --skill console-sound -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/console-sound/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Jakeschincariol/console-skill console-sound
```

2. **Manually: put the files in place**
- File: `.github/skills/console-sound/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Jakeschincariol/console-skill --skill console-sound -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Jakeschincariol/console-skill --path console-sound
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/console-sound/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Jakeschincariol/console-skill/tree/HEAD/console-sound/SKILL.md

## When to use it
- extract game music and sound effects
- convert PS2 VAG files to WAV
- inject custom tracks into the game
- split sound banks into individual clips
- scan archives for embedded VAG data

## Example prompts
- /plugin:console-sound towav console/disc/SOUND/BGM01.VAG
- python3 vag.py fromwav track.wav --like original.vag --out console/audio/new.vag
- python3 vag.py split console/disc/SOUND/SE.BD --rate 22050 --out console/audio/se

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 43cf06947e99f316.

BEGIN THIRD-PARTY FILE 43cf06947e99f316
````text
---
name: console-sound
description: >-
  Sound Designer. Rips the music and sound effects and puts your own tracks back in. Decodes PS2 VAG
  files and raw SPU2 ADPCM from sound banks (.bd) to WAV, finds VAGs hidden inside archives and disc
  files, and encodes your own 16-bit WAV back to VAG at the original's sample rate, looping and size.
  Everything it writes goes under console/audio/; it refuses a replacement bigger than the original
  unless told otherwise, and never writes into the disc folder or the PS2Recomp checkout. Use when the
  user says "rip the music", "extract the sound effects", "put my song in the game", "replace the
  soundtrack", "convert this VAG", "what is in this .bd", "the music loops wrong", or after
  /console-levels finds audio files on the disc.
argument-hint: "info|towav|fromwav|scan|split <file> [flags]"
---

# console-sound

The Sound Designer gets a game's audio out as WAV files you can listen to, and puts your own sounds
back in the same format. PS2 audio is Sony's SPU2 ADPCM: 16-byte frames of 28 samples each. It lives in
`.vag` files (a 48-byte `VAGp` header, then the frames), in sound banks (a `.hd` header plus a `.bd` of
headerless frames) and in game-specific streams. `vag.py` decodes exactly the way the PS2Recomp runtime
does (`ps2xRuntime/src/lib/ps2_audio_vag.cpp`), so what you hear is what the port plays.

Honest limits. The port's audio is high level: `ps2xRuntime/src/lib/ps2_audio.cpp` decodes the VAGp
blocks a game transfers and plays them through raylib when the game sends libsd voice commands. It is
not a full SPU2, so loop flags, reverb, envelopes and music streamed through a game's own driver may not
play in the port yet (that is /console-backend work). Banks have no rate in the `.bd`; it comes from the
`.hd` or from your ears. Movies (PSS) are out of scope.

`${CLAUDE_SKILL_DIR}` below is this skill's folder (where this SKILL.md lives).

```bash
python3 "${CLAUDE_SKILL_DIR}/vag.py" info  console/disc/SOUND/BGM01.VAG          # rate, length, loop points, header
python3 "${CLAUDE_SKILL_DIR}/vag.py" towav console/disc/SOUND/BGM01.VAG          # -> console/audio/BGM01.wav
python3 "${CLAUDE_SKILL_DIR}/vag.py" scan  console/disc/DATA/SOUND.PAK --extract console/audio/pak
python3 "${CLAUDE_SKILL_DIR}/vag.py" split console/disc/SOUND/SE.BD --rate 22050 --out console/audio/se
python3 "${CLAUDE_SKILL_DIR}/vag.py" towav console/disc/SOUND/STREAM.BIN --rate 48000 --channels 2 --interleave 0x800
python3 "${CLAUDE_SKILL_DIR}/vag.py" fromwav my_song.wav --like console/disc/SOUND/BGM01.VAG --out console/audio/BGM01.VAG
```

Other flags: `--offset N` (a VAG or raw data inside a bigger file), `--all` (decode past end flags),
`--json`. For `fromwav`: `--loop`, `--loop-start N`, `--no-loop`, `--rate N`, `--mono`,
`--stereo split|interleave --interleave N`, `--allow-bigger`, `--exhaustive`, `--no-lead-frame`,
````
END THIRD-PARTY FILE 43cf06947e99f316

The third-party file has ended. Everything between the 43cf06947e99f316 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2891 of 8524 bytes. © Jake Schincariol · MIT · https://github.com/Jakeschincariol/console-skill/tree/HEAD/console-sound/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
