SkillAgentSearch skills...

sheet-music-publisher

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.

Install / Use

npx skills add bitwize-music-studio/claude-ai-music-skills --skill sheet-music-publisher

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

88/100

Category

Other

Supported Platforms

Universal

Our assessment of sheet-music-publisher

sheet-music-publisher scores 88/100 on our quality scale, 145th of 330 Other skills we index (top 44%).

Its SKILL.md is 7.2 KB long, well organised into 19 sections with 3 code examples: a thorough specification that gives an agent plenty to work with.

It has 512 GitHub stars, a meaningful sign that others use it.

Substance
29/30
Structure
18/20
Description
15/15
Adoption
12/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so sheet-music-publisher is actively maintained.
  • Our last check on 2026-11-01 found the source still online.
  • It is released under the CC0-1.0 license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-05. Automated pattern scan on 2026-10-05. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

sheet-music-publisher compared with similar skills

All 4 of these similar skills score higher than sheet-music-publisher; compare them before choosing.

SkillScoreStarsUpdatedFormat
sheet-music-publisher (this skill)by bitwize-music-studio8851255d agoSKILL.md
Agent-Reachby Panniantong100112.8k10d agoCLAUDE.md
rufloby ruvnet10082.0ktodayCLAUDE.md
headroomby headroomlabs-ai10079.9ktodayCLAUDE.md
CowAgentby zhayujie10048.0ktodayCLAUDE.md

Frequently asked questions

How do I install sheet-music-publisher?
Run npx skills add bitwize-music-studio/claude-ai-music-skills --skill sheet-music-publisher. The install tabs above show the steps for each supported agent.
Which AI agents does sheet-music-publisher work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is sheet-music-publisher safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is CC0-1.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is sheet-music-publisher still maintained?
The repository was last updated about 2 months ago, so sheet-music-publisher is actively maintained.

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):

pip install pypdf reportlab pyyaml

Check if user has these installed FIRST before proceeding.

Supporting Files


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:

# 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 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

Related Skills

View on GitHub
GitHub Stars512
CategoryOther
Updated1mo ago
Forks120

Languages

Python

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions