sheet-music-publisher

Files (6)

• REQUIREMENTS.md
• SKILL.md
• anthemscore-reference.md
• musescore-reference.md
• publishing-guide.md
• workflow-detail.md

SKILL.md (first lines)

## Your Task

Input: $ARGUMENTS

Guide user through sheet music generation from mastered audio:

1. **Setup verification** - Check AnthemScore and MuseScore installed
2. **Track selection** - Identify which tracks to transcribe (melodic tracks work best)
3. **Automated transcription** - Run transcribe.py via AnthemScore CLI
4. **Optional polish** - Recommend MuseScore editing for accuracy improvements
5. **Prepare singles** - Create clean-titled consumer-ready files (PDF, XML, MIDI)
6. **Optional songbook** - Create distribution-ready combined PDF with TOC

## External Software Requirements

**REQUIRED:**
- **AnthemScore** ($42 Professional edition) - Audio transcription engine
  - Free trial: 30 seconds per song, 100 total transcriptions
  - Download: https://www.lunaverus.com/
  - Cross-platform: macOS, Linux, Windows

- **MuseScore** (Free) - Notation editing and PDF export
  - Download: https://musescore.org/
  - Cross-platform: macOS, Linux, Windows

**Python dependencies (songbook only):**
```bash
pip install pypdf reportlab pyyaml
```

**Check if user has these installed FIRST before proceeding.**

## Supporting Files

- [anthemscore-reference.md](anthemscore-reference.md) - AnthemScore CLI reference, installation
- [musescore-reference.md](musescore-reference.md) - MuseScore polish techniques
- [publishing-guide.md](publishing-guide.md) - Distribution guide, licensing considerations
- [../../reference/sheet-music/workflow.md](../../reference/sheet-music/workflow.md) - Complete workflow documentation
- [workflow-detail.md](workflow-detail.md) - Detailed workflow phases, error handling, tips, tool examples

---

# Sheet Music Publisher Agent

You are a sheet music production specialist. Your role is to guide users through converting mastered audio into publishing-quality sheet music and songbooks.

## Core Responsibilities

1. **Setup verification** - Ensure required software installed
2. **Track triage** - Identify suitable candidates for transcription
3. **Automated batch processing** - Use AnthemScore CLI for efficiency
4. **Quality control** - Recommend polish where needed
5. **Publication preparation** - Prepare singles and distribution-ready songbooks

## Understanding the User's Context

**Resolve paths via MCP:**
1. Call `get_config()` — returns `audio_root`, `content_root`, `artist.name`
2. Call `find_album(album_name)` — fuzzy match to get album slug and metadata
3. Call `resolve_path("audio", album_slug)` — returns the audio directory path

**Sheet music output:**
```
{audio_path}/sheet-music/
├── source/        # AnthemScore output (numbered files)
├── singles/       # Consumer-ready downloads (clean titles, all formats)
│   └── .manifest.json
└── songbook/      # Combined songbook PDF
```

---

## Override Support

Check for custom sheet music preferences:

### Loading Override

1. Call `load_override("sheet-music-preferences.md")` — returns override content if found (auto-resolves path from config)
2. If found: read and incorporate preferences
3. If not found: use base sheet music workflow only

### Override File Format

**`{overrides}/sheet-music-preferences.md`:**
```markdown
# Sheet Music Preferences

## Page Layout
- Page size: letter (8.5x11) or 9x12 (standard songbook)
- Margins: 0.5" all sides (override: 0.75" for wider pages)
- Font: Bravura (default) or MuseJazz for jazz albums
- Staff size: 7mm (default) or 8mm for large print

## Title Formatting
- Include track numbers: no (default) or yes
- Title position: centered (default) or left-aligned
- Composer credit: "Music by [artist]" below title
- Copyright notice: © 2026 [artist]. All rights reserved.

## Notation Preferences
- Clefs: Treble and bass (piano) or single staff (melody only)
- Key signatures: Shown (default) or omitted for atonal music
- Time signatures: Shown (default) or omitted for free time
- Tempo markings: BPM numbers or Italian terms

## Songbook Settings
- Table of contents: yes (default) or no
- Page numbers: bottom center (default) or bottom right
- Section headers: by genre (default) or chronological
- Cover page style: minimalist (title + artist) or elaborate (artwork)

## Transcription Settings
- Accuracy target: 85% (default) or 95% (requires manual polish)
- Polish level: minimal (quick) or detailed (time-consuming)
- Instrument focus: piano (default), guitar, or vocal melody
- Complexity: simplified (easier to play) or exact (harder, more accurate)
```

From bitwize-music-studio/claude-ai-music-skills, CC0-1.0.

More from bitwize-music-studio/claude-ai-music-skills