Skip to content
Back to search

bitwize-music

MarketplaceWorks with Claude CodeGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/bitwize-music-studio-claude-ai-music-skills/badge.svg)](/listings/bitwize-music-studio-claude-ai-music-skills)

HTML

<a href="/listings/bitwize-music-studio-claude-ai-music-skills"><img src="/api/listings/bitwize-music-studio-claude-ai-music-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

/plugin marketplace add bitwize-music-studio/claude-ai-music-skills
/plugin install bitwize-music@bitwize-music

Then run `/bitwize-music:setup` to detect your environment and install dependencies. Run `/bitwize-music:configure` to set your artist name and workspace paths.

**Platform**: macOS, Linux, WSL2, and native Windows are all fully supported. The full test suite runs on windows-latest in CI (plus dedicated Windows legs for the MCP boot check and MuseScore PDF export) — the MCP server, state cache, non-audio workflow, and the ffmpeg audio pipeline all run natively there. Promo video works on Windows too, though it's verified by hand rather than continuously guarded (its tests mock ffmpeg). Sheet music works natively too: MuseScore PDF export is CI-verified on windows-latest, and AnthemScore transcription runs against a licensed install (its free trial exposes no CLI on any OS, so that caveat isn't Windows-specific). Python 3.11+ for the MCP server and audio tools. See the [compatibility matrix](reference/cross-platform/tool-compatibility-matrix.md) for the per-feature breakdown.

OpenAI Codex (experimental)

Codex can install the plugin from this repository too:

codex plugin marketplace add bitwize-music-studio/claude-ai-music-skills
codex plugin add bitwize-music@bitwize-music

All 61 skills load, and the MCP server runs from the same `~/.bitwize-music/venv` that Claude Code uses, on macOS, Linux and Windows. The `setup` skill still assumes Claude Code, so if you haven't set the plugin up there, create the venv by hand (Python 3.11+):

python3 -m venv ~/.bitwize-music/venv
~/.bitwize-music/venv/bin/python -m pip install -r https://raw.githubusercontent.com/bitwize-music-studio/claude-ai-music-skills/main/requirements.txt

On Windows (cmd), run `python -m venv %USERPROFILE%\.bitwize-music\venv`, then `%USERPROFILE%\.bitwize-music\venv\Scripts\python.exe -m pip install -r` with the same URL.

So far Codex support covers discovery and the MCP tools, and many skills still assume Claude Code. [#548](https://github.com/bitwize-music-studio/claude-ai-music-skills/issues/548) tracks the rest.

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 14 lines
  1. {
  2. "name": "bitwize-music",
  3. "owner": {
  4. "name": "bitwize-music-studio"
  5. },
  6. "plugins": [
  7. {
  8. "name": "bitwize-music",
  9. "description": "AI music generation workflow for Suno - album concepts, lyrics, prompts, mastering, release",
  10. "version": "0.104.1",
  11. "source": "./"
  12. }
  13. ]
  14. }
README.md · README · 206 lines
  1. # Claude AI Music Skills
  2. I love music but never learned an instrument. AI became the creative outlet that was always out of reach. This project started as a way to go deep on Claude Code plugin architecture, agentic workflows, multi-model orchestration, and MCP tooling. Music was the domain because it was personal.
  3. What it actually does: a Claude Code plugin that turns a conversation into a full album production pipeline. You describe what you want to make, and it handles concept development, lyrics, [Suno](https://suno.com) prompts (an AI music generation platform), audio mastering, and release prep — with quality gates and source verification at every stage.
  4. Questions? See the [FAQ](FAQ.md).
  5. ![Version](https://img.shields.io/github/v/release/bitwize-music-studio/claude-ai-music-skills?label=version&color=blue)
  6. > [!NOTE]
  7. > Active development happens on the `develop` branch — `main` only receives tested, stable releases. If you run into issues, [open an issue](https://github.com/bitwize-music-studio/claude-ai-music-skills/issues) or submit a PR.
  8. ---
  9. ## See It in Action
  10. ![Listening to two takes in iTerm2 panes beside Claude Code, with the track's lyrics below](docs/images/listen-iterm2.gif)
  11. `/bitwize-music:listen the-nub 02 --iterm2` opens both takes of a track as Suno players beside the session, with the track's lyrics underneath, so you can hear them side by side without leaving the terminal.
  12. macOS is my daily driver, so it's where this plugin gets the most real-world use. Every change is also tested on Linux and Windows in CI. The iTerm2 panes shown here need macOS. Everywhere else, the same command opens your takes in the browser.
  13. ## Example Workflow
  14. ```
  15. You: "Let's make an album about the 2016 Bangladesh Bank heist"
  16. Claude: Creates album structure, runs 7-phase concept planning
  17. You: "Start the research"
  18. Claude: Dispatches legal, financial, and security researchers in parallel
  19. Gathers DOJ filings, SWIFT documentation, malware analysis
  20. Cross-verifies sources, flags claims that need human review
  21. You: "Sources look good. Let's write track 1"
  22. Claude: Drafts lyrics, checks prosody and rhyme schemes
  23. Scans for pronunciation risks, suggests phonetic fixes
  24. Builds the Suno style prompt and generation settings (model, Variety, Max Mode)
  25. You: "Track sounds great, here are the stems"
  26. Claude: Imports stems from Suno, polishes per-stem
  27. Masters to -14 LUFS for streaming
  28. Generates promo video and social media copy
  29. ```
  30. Concept to released album, from the terminal. Connect Suno's own MCP server and generation happens there too — and you still listen to every take before it's approved.
  31. > [!WARNING]
  32. > [Suno's MCP server](https://suno.com/mcp) is an invite-only beta: you can connect it only once Suno has invited you. Without it, the rest of the plugin works the same, and you paste the lyrics and style prompt into suno.com as before. Suno is also updating the server constantly, so the skills that use it (`generate`, `listen`, `check-take`, `edit-take`, `extend-take`, `sound-effects`, `suno-voice` and `import-audio --from-suno`) may break without warning until Suno officially releases it.
  33. ---
  34. ## Install
  35. ```bash
  36. /plugin marketplace add bitwize-music-studio/claude-ai-music-skills
  37. /plugin install bitwize-music@bitwize-music
  38. ```
  39. Then run `/bitwize-music:setup` to detect your environment and install dependencies. Run `/bitwize-music:configure` to set your artist name and workspace paths.
  40. **Platform**: macOS, Linux, WSL2, and native Windows are all fully supported. The full test suite runs on windows-latest in CI (plus dedicated Windows legs for the MCP boot check and MuseScore PDF export) — the MCP server, state cache, non-audio workflow, and the ffmpeg audio pipeline all run natively there. Promo video works on Windows too, though it's verified by hand rather than continuously guarded (its tests mock ffmpeg). Sheet music works natively too: MuseScore PDF export is CI-verified on windows-latest, and AnthemScore transcription runs against a licensed install (its free trial exposes no CLI on any OS, so that caveat isn't Windows-specific). Python 3.11+ for the MCP server and audio tools. See the [compatibility matrix](reference/cross-platform/tool-compatibility-matrix.md) for the per-feature breakdown.
  41. ### OpenAI Codex (experimental)
  42. Codex can install the plugin from this repository too:
  43. ```bash
  44. codex plugin marketplace add bitwize-music-studio/claude-ai-music-skills
  45. codex plugin add bitwize-music@bitwize-music
  46. ```
  47. All 61 skills load, and the MCP server runs from the same `~/.bitwize-music/venv` that Claude Code uses, on macOS, Linux and Windows. The `setup` skill still assumes Claude Code, so if you haven't set the plugin up there, create the venv by hand (Python 3.11+):
  48. ```bash
  49. python3 -m venv ~/.bitwize-music/venv
  50. ~/.bitwize-music/venv/bin/python -m pip install -r https://raw.githubusercontent.com/bitwize-music-studio/claude-ai-music-skills/main/requirements.txt
  51. ```
  52. On Windows (cmd), run `python -m venv %USERPROFILE%\.bitwize-music\venv`, then `%USERPROFILE%\.bitwize-music\venv\Scripts\python.exe -m pip install -r` with the same URL.
  53. So far Codex support covers discovery and the MCP tools, and many skills still assume Claude Code. [#548](https://github.com/bitwize-music-studio/claude-ai-music-skills/issues/548) tracks the rest.
  54. ---
  55. ## Architecture
  56. This is where the engineering lives. The plugin is a case study in how far you can push Claude Code's plugin system.
  57. ### Skill System (61 Skills)
  58. Each skill is a self-contained markdown file with a YAML frontmatter that declares its model, description, and when it should activate. Skills range from simple clipboard operations to multi-step creative workflows. Claude routes to skills automatically based on context, or you invoke them directly with `/bitwize-music:<name>`.
  59. The lyric-writer knows prosody rules, rhyme scheme analysis, and Suno's pronunciation quirks. The mastering-engineer knows loudness targets per platform and genre-specific EQ curves. The researcher coordinates parallel sub-agents across 10 domain specializations.
  60. See [docs/skills.md](docs/skills.md) for the full reference.
  61. ### Multi-Model Orchestration
  62. Skills declare which Claude model they need. Creative work that directly impacts music quality runs on Opus. Coordination and reasoning tasks use Sonnet. Mechanical operations (imports, validation, clipboard) run on Haiku.
  63. | Tier | `model:` | Skills | Rationale |
  64. |------|----------|--------|-----------|
  65. | Creative | `opus` | 7 | Lyrics, Suno prompts, album concepts, legal/verification research — output quality defines the music |
  66. | Reasoning | `sonnet` | 37 | Research coordination, pronunciation analysis, most workflows |
  67. | Mechanical | `haiku` | 15 | Imports, validation, clipboard, help — speed over creativity |
  68. Skills declare the tier alias, not a pinned version, so each one tracks the current frontier model in its tier automatically — no per-skill edit when a new Claude generation ships.
  69. This project pushes Claude Code hard — multi-agent research, real-time audio analysis, sub-agent orchestration across model tiers. It works best on the Max subscription. The standard Pro subscription will hit rate limits during multi-track sessions.
  70. See [reference/model-strategy.md](reference/model-strategy.md) for per-skill rationale.
  71. ### MCP Server (80+ Tools)
  72. A Python MCP server exposes 80+ tools for instant state queries, audio analysis, lyrics processing, and database operations. The server is the plugin's nervous system — skills call MCP tools instead of reading files directly, which keeps responses fast and state consistent.
  73. Key tool categories:
  74. - **State management** — album/track lookups, session context, cache rebuild
  75. - **Lyrics analysis** — syllable counting, readability scoring, rhyme detection, section validation, cross-track repetition
  76. - **Audio processing** — mastering, stem analysis, QC checks, promo video generation
  77. - **Database** — tweet/promo content management via PostgreSQL
  78. ### Research System
  79. For documentary and true-story albums, the research system coordinates parallel investigation across 10 domain-specific sub-agents. A lead researcher dispatches to specialists (legal, financial, security, government, journalism, etc.), each trained on where to find primary sources in their domain. A verification agent cross-checks all claims before human review.
  80. The full pipeline: gather sources, verify citations, require human sign-off, then — and only then — allow lyrics generation. Every claim in the music traces back to a captured, verified source.
  81. ### Quality Gates
  82. Nothing ships without passing gates:
  83. - **Lyrics**: 13-point checklist (rhyme, prosody, pronunciation, POV consistency, factual accuracy)
  84. - **Pre-generation**: Sources verified, explicit flags set, style prompt complete, artist names cleared
  85. - **Audio**: 7-point QC (loudness, clipping, silence, phase, stereo width, frequency balance, dynamic range)
  86. - **Structure**: Album directory validation, file location checks, content integrity
  87. ### Genre Coverage
  88. 72 genre directories with production guides, mastering presets, artist deep-dives, and Suno-specific tips. From afrobeats to vaporwave, each genre includes subgenre breakdowns, lyric conventions, and reference artists.
  89. ### CI/CD
  90. 6 GitHub Actions workflows: tests (6,022 across ubuntu/macOS/Windows, plus lint, security scanning with bandit + pip-audit, and static validation), real-service integration (Postgres, SeaweedFS/S3, MuseScore), nightly deep tests, auto-release from changelog, PR target enforcement, and version sync. Dependabot watches pip and Actions versions weekly.
  91. Coverage is measured on all three OSes and gated on the **combined** total, not one platform's view. That matters because every `sys.platform == "win32"` branch is unreachable on Linux — measuring only there made the platform-specific code invisible to the gate, which is exactly where this project's real bugs have lived. The merge is asserted rather than assumed: a mis-specified path mapping makes `coverage combine` report the Linux-only number while looking like success, so the job fails unless a known win32-only line is genuinely covered.
  92. ---
  93. ## Project Structure
  94. ```
  95. skills/ 60 skill definitions (markdown + YAML frontmatter)
  96. servers/ MCP server (Python, 80+ tools)
  97. tools/ Audio mastering, promo videos, sheet music, cloud uploads
  98. reference/ 46+ docs — Suno guides, mastering workflows, genre references
  99. genres/ 72 genre directories with production guides
  100. templates/ Album, track, artist, research templates
  101. tests/ 4,412 tests across 14 categories
  102. config/ Example config and setup docs
  103. ```
  104. ---
  105. ## Detailed Documentation
  106. | Topic | Location |
  107. |-------|----------|
  108. | All 61 skills | [docs/skills.md](docs/skills.md) |
  109. | Configuration | [docs/configuration.md](docs/configuration.md) |
  110. | Troubleshooting | [docs/troubleshooting.md](docs/troubleshooting.md) |
  111. | Changelog | [CHANGELOG.md](CHANGELOG.md) |
  112. | Contributing | [CONTRIBUTING.md](CONTRIBUTING.md) |
  113. | Model strategy | [reference/model-strategy.md](reference/model-strategy.md) |
  114. | Skill decision tree | [reference/SKILL_INDEX.md](reference/SKILL_INDEX.md) |
  115. | Suno best practices | [reference/suno/best-practices.md](reference/suno/best-practices.md) |
  116. | Suno model catalog | [reference/suno/models.md](reference/suno/models.md) |
  117. | The story behind bitwize-music | [bitwizemusic.com/behind-the-music](https://www.bitwizemusic.com/behind-the-music/) |
  118. ---
  119. ## Contributors
  120. <a href="https://github.com/bitwize-music"><img src="https://images.weserv.nl/?url=github.com/bitwize-music.png&h=60&w=60&fit=cover&mask=circle" width="60" height="60" alt="@bitwize-music"></a>
  121. <a href="https://github.com/markus-michalski"><img src="https://images.weserv.nl/?url=github.com/markus-michalski.png&h=60&w=60&fit=cover&mask=circle" width="60" height="60" alt="@markus-michalski"></a>
  122. <a href="https://github.com/zeel2104"><img src="https://images.weserv.nl/?url=github.com/zeel2104.png&h=60&w=60&fit=cover&mask=circle" width="60" height="60" alt="@zeel2104"></a>
  123. <a href="https://github.com/alijahak"><img src="https://images.weserv.nl/?url=github.com/alijahak.png&h=60&w=60&fit=cover&mask=circle" width="60" height="60" alt="@alijahak"></a>
  124. <a href="https://github.com/DaveMatNat"><img src="https://images.weserv.nl/?url=github.com/DaveMatNat.png&h=60&w=60&fit=cover&mask=circle" width="60" height="60" alt="@DaveMatNat"></a>
  125. <a href="https://github.com/thejesh23"><img src="https://images.weserv.nl/?url=github.com/thejesh23.png&h=60&w=60&fit=cover&mask=circle" width="60" height="60" alt="@thejesh23"></a>
  126. <a href="https://github.com/tgh612"><img src="https://images.weserv.nl/?url=github.com/tgh612.png&h=60&w=60&fit=cover&mask=circle" width="60" height="60" alt="@tgh612"></a>
  127. <a href="https://github.com/MrReasonable"><img src="https://images.weserv.nl/?url=github.com/MrReasonable.png&h=60&w=60&fit=cover&mask=circle" width="60" height="60" alt="@MrReasonable"></a>
  128. <a href="https://github.com/medinabestari"><img src="https://images.weserv.nl/?url=github.com/medinabestari.png&h=60&w=60&fit=cover&mask=circle" width="60" height="60" alt="@medinabestari"></a>
  129. <a href="https://github.com/cbrahms"><img src="https://images.weserv.nl/?url=github.com/cbrahms.png&h=60&w=60&fit=cover&mask=circle" width="60" height="60" alt="@cbrahms"></a>
  130. <a href="https://github.com/wufei-png"><img src="https://images.weserv.nl/?url=github.com/wufei-png.png&h=60&w=60&fit=cover&mask=circle" width="60" height="60" alt="@wufei-png"></a>
  131. If you make something with this, I'd genuinely love to hear it — [@bitwizemusic](https://x.com/bitwizemusic) on X, [join the Discord](https://discord.gg/dMURByGF), or [open a discussion](https://github.com/bitwize-music-studio/claude-ai-music-skills/discussions).
  132. ---
  133. ## License
  134. CC0 — Public Domain. Do whatever you want with it.
  135. ## Disclaimer
  136. Artist and song references in the genre documentation are for educational and reference purposes only. This plugin does not encourage creating infringing content. Users are responsible for ensuring their generated content complies with applicable laws and platform terms of service.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.