split-audio

Split source MP3s into per-segment files and update route.json for JR East style simulator workflows.

17|3|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/ksleungac/pids-jre-simulator --skill split-audio
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: split-audio
Source: https://github.com/ksleungac/pids-jre-simulator/tree/main/.claude/skills/split-audio
Command: npx skills add https://github.com/ksleungac/pids-jre-simulator --skill split-audio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps automate the process of turning a single long audio file and its timestamps into individual segment files for PA/STA usage, while keeping a clean, traceable route.json update workflow.

Core Features & Use Cases

  • Generate per-segment MP3s stored under audio/<line>/<diagram>/pa or audio/<line>/<diagram>/sta according to the segment type.
  • Create ad-hoc splitter scripts at the source folder that document how each batch was split, preserving audit trails.
  • Auto-populate or update route.json with the new basenames and timing fields (sta_cut) so the simulator can reference the correct audio.

Quick Start

Provide your audio source folder and timestamps file, then run the generated splitter to produce per-segment files and update route.json.

Frequently Asked Questions about split-audio

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I split a continuous MP3 into segment files using ffmpeg and timestamps?▼

Splitting a continuous MP3 into segment files requires a source folder and timestamp files. This Skill processes the audio and outputs individual MP3s under an audio/<line>/<diagram>/pa or sta directory structure.

How do I automate audio splitting and update route.json for a simulator?▼

Automating audio splitting and route.json updates is handled by generating an ad-hoc splitter script next to your audio source. This script executes the MP3 cuts and auto-populates route.json with new basenames and sta_cut timing fields.

What is the best way to maintain an audit trail when splitting audio for workflows?▼

To maintain an audit trail when splitting audio, the Skill creates ad-hoc splitter scripts at the source folder. These scripts document exactly how each batch was split, preserving a traceable workflow history.

Can I split audio for both PA and STA workflows across multiple routes?▼

Yes, you can split audio for both PA and STA workflows across multiple routes. The Skill supports varying timestamp formats and per-source split scripts to organize files into respective pa and sta output directories.

Do I need to manually organize segment files after splitting a source MP3?▼

No, you do not need to manually organize segment files after splitting a source MP3. The Skill automatically outputs files into the correct audio/<line>/<diagram>/pa or sta structure and updates the simulator's route.json.

Why does my route.json not reference the correct audio after splitting MP3s?▼

If route.json does not reference the correct audio after splitting MP3s, ensure the generated splitter script was executed. The script automatically populates route.json with new basenames and sta_cut timing fields for the simulator.