claude-ai-music-skills

about

skills/about/SKILL.md

Provides information about the bitwize-music plugin, its version, and its creator. Use when the user asks about the plugin, its purpose, version, or capabilities.

album-art-director

skills/album-art-director/SKILL.md

Creates visual concepts for album artwork and generates AI art prompts. Use during planning for concept discussion, or after all tracks are Final for actual artwork generation.

album-conceptualizer

skills/album-conceptualizer/SKILL.md

Designs album concepts, tracklist architecture, and thematic planning through 7 structured phases. Use when planning a new album or reworking an existing album concept.

album-dashboard

skills/album-dashboard/SKILL.md

Shows a structured progress dashboard for an album with percentage complete per phase, blocking items, and status breakdown. Use for a quick visual overview of album progress.

album-ideas

skills/album-ideas/SKILL.md

Tracks and manages album ideas including brainstorming, planning, and status updates. Use when the user wants to add, review, or organize their album idea backlog.

clipboard

skills/clipboard/SKILL.md

Copies track content (lyrics, style prompts, streaming lyrics) to the system clipboard. Use when the user needs to paste lyrics or style prompts into Suno or other external tools.

cloud-uploader

skills/cloud-uploader/SKILL.md

Uploads promo videos and content to Cloudflare R2 or AWS S3. Use when the user wants to host promo content for social media or distribution.

configure

skills/configure/SKILL.md

Sets up or edits the plugin configuration file interactively. Use on first-time setup, when config is missing, or when the user wants to change settings.

document-hunter

skills/document-hunter/SKILL.md

Searches and retrieves documents from free public sources using automated browser navigation. Use when research needs primary source documents like court filings, government reports, or public records.

explicit-checker

skills/explicit-checker/SKILL.md

Scans lyrics for explicit content and verifies that explicit flags match actual content. Use before Suno generation or release to ensure accurate content ratings.

genre-creator

skills/genre-creator/SKILL.md

Create new genre documentation files for the bitwize-music genre library. Use when the user wants to add a genre, says "/genre-creator", "neues Genre erstellen", "Genre hinzufuegen", "add genre", or asks to create genre documentation. Takes a genre name as argument.

health-check

skills/health-check/SKILL.md

Runs plugin health checks (venv packages, skill registration, and album slug collisions). Use when the user asks to check plugin health, verify setup, or troubleshoot missing skills.

help

skills/help/SKILL.md

Shows available skills, common workflows, and quick reference for the plugin. Use when the user asks for help, what skills are available, or how to do something.

import-art

skills/import-art/SKILL.md

Places album art files in the correct audio and content directory locations. Use when the user has generated or downloaded album artwork that needs to be saved.

import-audio

skills/import-audio/SKILL.md

Moves audio files to the correct album location with proper path structure. Use when the user has downloaded WAV files from Suno or other sources that need to be organized.

import-track

skills/import-track/SKILL.md

Moves track markdown files to the correct album location. Use when the user has track files in Downloads or other locations that need to be placed in an album.

lyric-refiner

skills/lyric-refiner/SKILL.md

Autonomous multi-pass lyric refinement for tightening, cohesion, and album unity. Use after lyrics are written to polish a track or entire album through iterative passes.

lyric-reviewer

skills/lyric-reviewer/SKILL.md

Reviews lyrics against a quality checklist before Suno generation. Use before generating tracks to catch rhyme, prosody, pronunciation, and structural issues.

lyric-writer

skills/lyric-writer/SKILL.md

Writes or reviews lyrics with professional prosody, rhyme craft, and quality checks. Use when writing new lyrics, revising existing lyrics, or when the user says 'let's work on a track.

mastering-engineer

skills/mastering-engineer/SKILL.md

Guides audio mastering for streaming platforms including loudness optimization and tonal balance. Use when the user has approved tracks and wants to master audio files.

mix-engineer

skills/mix-engineer/SKILL.md

Polishes raw Suno audio by processing per-stem WAVs (vocals, backing_vocals, drums, bass, guitar, keyboard, strings, brass, woodwinds, percussion, synth, other) with targeted cleanup, EQ, and compression, then remixing into a polished stereo WAV ready for mastering. Use after audio import and before mastering.

new-album

skills/new-album/SKILL.md

Creates a new album with the correct directory structure and templates. Use IMMEDIATELY when the user says 'make a new album' or similar, before any discussion.

next-step

skills/next-step/SKILL.md

Analyzes album state and recommends the optimal next action. Use when the user asks "what should I do next?" or "what's left to do?

plagiarism-checker

skills/plagiarism-checker/SKILL.md

Scans lyrics for phrases that may match existing songs using web search and LLM knowledge. Use before release to check for unintentional borrowing.

pre-generation-check

skills/pre-generation-check/SKILL.md

Validates all pre-generation gates before sending tracks to Suno. Checks sources verified, lyrics reviewed, pronunciation resolved, explicit flag set, style prompt complete, and artist names cleared. Use before generating tracks on Suno or when the user says "pre-gen check" or "ready to generate".

promo-director

skills/promo-director/SKILL.md

Generates 15-second vertical promo videos for social media from mastered audio. Use after mastering is complete and before release, when the user wants social media content.

promo-reviewer

skills/promo-reviewer/SKILL.md

Reviews and iterates on social media copy in album promo/ files. Use after populating promo templates and before release to polish platform-specific posts.

promo-writer

skills/promo-writer/SKILL.md

Generates platform-specific social media copy from album themes, track concepts, and lyrics. Use when promo/ templates need to be populated before release.

promote-idea

skills/promote-idea/SKILL.md

Converts an album idea from IDEAS.md into an actual album project in one step. Use when the user says "promote [idea title]", "turn idea into album", or "start working on [idea]".

pronunciation-specialist

skills/pronunciation-specialist/SKILL.md

Scans lyrics for pronunciation risks and prevents Suno mispronunciations. Use when writing lyrics with proper nouns, technical terms, homographs, or non-English words.

release-director

skills/release-director/SKILL.md

Coordinates album release including QA, distribution prep, and platform uploads. Use when mastering and album art are complete and the user is ready to release.

rename

skills/rename/SKILL.md

Renames an album or track, updating slugs, titles, and all mirrored paths. Use when the user wants to rename an album or track.

researcher

skills/researcher/SKILL.md

Conducts investigative-grade research with primary source analysis, cross-verification, and trial-level depth. Use when an album needs factual research, source material, or verification of claims.

researchers-biographical

skills/researchers-biographical/SKILL.md

Researches personal backgrounds, interviews, motivations, and humanizing details. Use when research needs biographical context about people involved in the album's subject.

researchers-financial

skills/researchers-financial/SKILL.md

Researches SEC filings, earnings calls, analyst reports, and market data. Use when the album subject involves financial crimes, corporate stories, or market events.

researchers-gov

skills/researchers-gov/SKILL.md

Researches DOJ/FBI/SEC press releases, agency statements, and government sources. Use when research needs official government records or agency documentation.

researchers-historical

skills/researchers-historical/SKILL.md

Researches archives, contemporary accounts, and timeline reconstruction. Use when the album subject involves historical events that need primary source verification.

researchers-journalism

skills/researchers-journalism/SKILL.md

Researches investigative articles, interviews, and news coverage. Use when research needs journalistic sources for cross-referencing or additional context.

researchers-legal

skills/researchers-legal/SKILL.md

Researches court documents, indictments, plea agreements, and sentencing records. Use when the album subject involves legal proceedings or criminal cases.

researchers-primary-source

skills/researchers-primary-source/SKILL.md

Researches the subject's own words from tweets, blogs, forums, and chat logs. Use when research needs direct quotes or first-person accounts.

researchers-security

skills/researchers-security/SKILL.md

Researches malware analysis, CVEs, attribution reports, and hacker community sources. Use when the album subject involves cybersecurity incidents or threat actors.

researchers-tech

skills/researchers-tech/SKILL.md

Researches project histories, changelogs, developer interviews, and open source documentation. Use when the album subject involves technology projects or developer stories.

researchers-verifier

skills/researchers-verifier/SKILL.md

Performs quality control, citation validation, and fact-checking before human review. Use after research is complete to verify all sources and claims before production.

resume

skills/resume/SKILL.md

Finds an album by name and shows detailed status with next steps. Use when the user mentions an album name or wants to continue previous work.

session-start

skills/session-start/SKILL.md

Runs the session startup procedure - verifies setup, loads config and state, checks skill models, and reports project status. Use at the beginning of a fresh session.

setup

skills/setup/SKILL.md

Detects your Python environment and guides you through installing plugin dependencies. Use on first-time setup or when MCP server fails to start.

sheet-music-publisher

skills/sheet-music-publisher/SKILL.md

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.

suno-engineer

skills/suno-engineer/SKILL.md

Constructs technical Suno style prompts for the current model family (v6, v6-wild, v6-mini), selects models and generation settings, and optimizes prompts. Use when creating or refining Suno prompts for track generation.

test

skills/test/SKILL.md

Runs automated tests to validate plugin integrity across 14 categories. Use before creating PRs, after making changes to skills or templates, or to verify plugin health.

tutorial

skills/tutorial/SKILL.md

Provides interactive guided album creation for new users. Use when the user is new to the plugin or asks for a walkthrough of the album creation process.

validate-album

skills/validate-album/SKILL.md

Validates album directory structure, file locations, and content integrity. Use before release or whenever the user wants to check an album's structural health.

verify-sources

skills/verify-sources/SKILL.md

Captures human source verification for tracks, timestamps it, and updates track files. Use when sources need human review before generation.

voice-checker

skills/voice-checker/SKILL.md

Reviews lyrics and prose for AI-written patterns (abstract noun stacking, over-explained metaphors, cliche escalation, missing idiosyncrasy, prose AI tells). Advisory Warning/Info severity — flags issues, does not block or rewrite. Use when reviewing lyrics for authenticity or before generation to catch AI-sounding language.