sheet-music-publisher — скилл для Claude Code: ноты и установка
Скилл sheet-music-publisher преобразует мастеринг в ноты и собирает печатный песенник. Пригодится после сведения альбома, когда нужны PDF, XML, MIDI или общий PDF.
CC0-1.0 270 установок ★ 686 обновлён 2026-10-22
npx skills add bitwize-music-studio/claude-ai-music-skills --skill sheet-music-publisher -a claude-codeЧто делает sheet-music-publisher
Скилл ведёт работу от проверки окружения до публикации нот. Он помогает выбрать треки, запустить транскрипцию через AnthemScore CLI, проверить результат и при необходимости обработать его в MuseScore. Мелодические партии подходят лучше сложных миксов.
Для отдельных треков создаются PDF, XML и MIDI с чистыми названиями. Песенник собирается в общий PDF с оглавлением; для этой части нужны Python-пакеты pypdf, reportlab и pyyaml. Пути к альбому и папкам с аудио скилл получает через bitwize-music-mcp.
AnthemScore и MuseScore обязательны: без них рабочий процесс не запустится. AnthemScore нужен для транскрипции, MuseScore — для правки нот и экспорта PDF; после автоматической обработки может потребоваться ручная полировка.
Какие задачи решает
- преобразовать мастеринг в нотную запись
- выбрать подходящие треки для транскрипции
- подготовить PDF, XML и MIDI для отдельных песен
- собрать общий PDF-песенник с оглавлением
- проверить и отполировать результат в MuseScore
Примеры запросов агенту
- Преобразуй альбом
<album-name or /path/to/track.wav>в ноты и подготовь файлы для публикации. - Проверь окружение, выбери мелодические треки и запусти транскрипцию через AnthemScore.
- Собери из нот альбома общий PDF-песенник с оглавлением.
Как установить sheet-music-publisher
1Через Skills CLI (Vercel)
npx skills add bitwize-music-studio/claude-ai-music-skills --skill sheet-music-publisher -a claude-code2Вручную: положить файлы
~/.claude/skills/sheet-music-publisher/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/sheet-music-publisher/
1Через Skills CLI (Vercel)
npx skills add bitwize-music-studio/claude-ai-music-skills --skill sheet-music-publisher -a codex2Вручную: положить файлы
.agents/skills/sheet-music-publisher/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add bitwize-music-studio/claude-ai-music-skills --skill sheet-music-publisher -a cursor2Вручную: положить файлы
.cursor/skills/sheet-music-publisher/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install bitwize-music-studio/claude-ai-music-skills skills/sheet-music-publisher2Вручную: положить файлы
.github/skills/sheet-music-publisher/SKILL.md1Через Skills CLI (Vercel)
npx skills add bitwize-music-studio/claude-ai-music-skills --skill sheet-music-publisher -a gemini-cli2Командой платформы
gemini skills install https://github.com/bitwize-music-studio/claude-ai-music-skills --path skills/sheet-music-publisherВручную: положить файлы
.devin/skills/sheet-music-publisher/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add bitwize-music-studio/claude-ai-music-skills --skill sheet-music-publisher -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о sheet-music-publisher
Как установить sheet-music-publisher в Claude Code?
Выполните npx skills add bitwize-music-studio/claude-ai-music-skills --skill sheet-music-publisher -a claude-code, затем откройте ~/.claude/skills/sheet-music-publisher/SKILL.md.
Что делает sheet-music-publisher?
Скилл превращает мастеринг в нотные файлы, подготавливает отдельные PDF, XML и MIDI, а также может собрать общий PDF-песенник.
Что нужно для работы sheet-music-publisher?
Нужны AnthemScore для транскрипции и MuseScore для редактирования и экспорта PDF. Для сборки песенника также устанавливаются pypdf, reportlab и pyyaml.
Исходный текст
SKILL.md · CC0-1.0
---
name: sheet-music-publisher
description: Converts mastered audio to sheet music and creates printable songbooks. Use after mastering when the user wants sheet music or a songbook for their album.
argument-hint: <album-name or /path/to/track.wav>
model: sonnet
effort: low
allowed-tools:
- Read
- Edit
- Write
- Grep
- Glob
- Bash
- bitwize-music-mcp
requirements:
external:
- name: AnthemScore
purpose: Audio to sheet music transcription
url: https://www.lunaverus.com/
cost: "$42 (Professional edition recommended)"
notes: "Free trial available: 30 seconds per song, 100 total transcriptions"
- name: MuseScore
purpose: Sheet music editing and PDF export
url: https://musescore.org/
cost: Free (open source)
notes: "Required for title cleanup and manual polishing"
python:
- pypdf
- reportlab
- pyyaml
---
## 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)
```
### How to Use Override
1. Load at invocation start
2. Apply page layout preferences to songbook creation
3. Use title formatting rules consistently
4. Follow notation preferences when polishing
5. Apply songbook settings to combined PDF
6. Override preferences guide but don't compromise quality
**Example:**
- User prefers 9x12 page size, large print
- User wants track numbers in titles
- Result: Generate songbook with 9x12 pages, 8mm staff, titles include track numbers
---
## Workflow Phases
See [workflow-detail.md](workflow-detail.md) for detailed steps on all 7 phases:
1. Setup Verification (AnthemScore, MuseScore, Python deps)
2. Track Selection
3. Automated Transcription (outputs to source/)
4. Quality Review & Polish
5. Prepare Singles (clean titles → singles/)
6. Songbook Creation (optional → songbook/)
7. Summary & Next Steps
Also covers: Error Handling, Tips for Better Results, Tool Invocation Examples, Quality Standards, Workflow State Tracking.
## Remember
1. **Load override first** - Call `load_override("sheet-music-preferences.md")` at invocation
2. **Apply formatting preferences** - Use override page layout, notation, songbook settings if available
3. **Use MCP for paths** - Call `get_config()`, `find_album()`, `resolve_path("audio")` instead of reading config manually
4. **Check software exists** - Graceful failure with install instructions
5. **Set expectations** - 70-95% accuracy, may need polish
6. **Offer polish** - Don't skip this step
7. **Automate what you can** - Use CLI tools, minimize manual work
8. **distribution-ready output** - Songbook should be upload-ready (with user preferences applied)
## Success Criteria
User should end with:
- ✓ Individual PDFs for each track (publishing-ready)
- ✓ MusicXML sources (editable in MuseScore)
- ✓ MIDI files for each track (playback)
- ✓ Optional: Combined songbook PDF (distribution-ready)
- ✓ Clear next steps for website distribution
- ✓ Understanding of quality level and polish needs
© bitwize-music-studio · CC0-1.0 · bitwize-music-studio/claude-ai-music-skills