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.