abc-notationlisted
Install: claude install-skill rockerBOO/abc-skill
# ABC Notation
ABC is a compact text notation for music. This skill turns ABC into (a) a normalized score plus a
**structure map** you can reason over, and (b) short audio clips a human can hear — because you
cannot hear the music yourself.
## When to use
- Reading, inspecting, summarizing, or validating ABC.
- Selecting part of a tune ("the chorus", "after the second verse").
- Arranging or mashing two or more tunes (medley, layering, transposition, tempo matching).
- Letting a human hear a clip and iterating on their feedback.
Not for: engraving sheet music, or studio-quality production.
## The loop
**analyze → decide (state the plan) → render a short clip → the human listens → map their feedback
to a knob → repeat.**
You cannot hear the result; the human's ear is the verifier. Always show the plan (key, tempo,
sections, mode, crossfade, gains) alongside the audio so feedback is actionable.
## Quick start
Run from this skill's directory (where this file lives). `<ref>` is a handle id from `send`, a file
path, or `-` for stdin.
```bash
# 1. hand ABC to the session; prints a handle id + structure summary
cat tune.abc | uv run python scripts/abcbox.py send
# 2. inspect the structure map (sections, times, active voices, chords)
uv run python scripts/abcbox.py sections <ref>
# 3. hear a short clip (default 5 seconds)
uv run python scripts/abcbox.py play <ref> --section chorus#2
uv run python scripts/abcbox.py play <ref> --after chorus#1 --seconds 5
# 4. playback con