agentleFS
bitwize-music-studiobitwize-music-studio/claude-ai-music-skills/skills/help/SKILL.md

help

Skill589 starsChanged 9 months agoCC0-1.0View on GitHub

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.

We split this skill into the rules it gives an agent

11 rules. 0 are common, 8 are distinctive, and 3 are very specific to this project.

  • 0

    Common

    Most of the 51 edited versions we read keep these.

  • 8

    Distinctive

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Write lyrics for each track

    line 100
  2. Very specific:

    Run /bitwize-music:lyric-reviewer before generation

    line 101
  3. Distinctive:

    Use researcher skills to gather sources

    line 109
  4. Distinctive:

    All sources must be verified by human before production

    line 110
  5. Very specific:

    Update track status from ❌ Pending to ✅ Verified (DATE)

    line 111
  6. Distinctive:

    Follow the recommended next steps

    line 116
  7. Distinctive:

    Pronunciation: Use phonetic spelling for tricky words (see pronunciation guide)

    line 123
  8. Distinctive:

    Explicit content: Use flag for: fuck, shit, bitch, cunt, cock, dick, pussy, etc.

    line 124
  9. Distinctive:

    Track status flow: Not Started → In Progress → Generated → Final

    line 127
  10. Very specific:

    Use this skill anytime: /bitwize-music:help

    line 146
  11. Distinctive:

    Ask Claude: "What should I do next?" for guidance

    line 149

“Common” is measured: kept by at least 6 in 10 of the 51 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

bitwize-music Plugin Help

Display this help information to the user in a clear, organized format.


Getting Started

New to the plugin?

  • /bitwize-music:tutorial - Interactive guided album creation
  • /bitwize-music:configure - Set up configuration file
  • /bitwize-music:about - About bitwize and this plugin

Resume existing work:

  • /bitwize-music:resume <album-name> - Find an album and see status/next steps

Skills by Category

Album & Track Creation

  • /bitwize-music:album-ideas - Track and manage album ideas
  • /bitwize-music:promote-idea - Convert a Pending idea into a full album (one-shot)
  • /bitwize-music:new-album - Create new album with directory structure
  • /bitwize-music:album-conceptualizer - Album concepts and tracklist architecture
  • /bitwize-music:lyric-writer - Write/review lyrics, fix prosody
  • /bitwize-music:lyric-refiner - Multi-pass lyric refinement and album cohesion
  • /bitwize-music:suno-engineer - Technical Suno prompting and genre selection
  • /bitwize-music:genre-creator - Add new genre documentation to the library

Research & Sources

  • /bitwize-music:researcher - Main research coordinator, fact-checking
  • /bitwize-music:document-hunter - Automated document search/download
  • /bitwize-music:researchers-legal - Court documents, indictments
  • /bitwize-music:researchers-gov - DOJ/FBI/SEC releases
  • /bitwize-music:researchers-tech - Project histories, changelogs
  • /bitwize-music:researchers-journalism - Investigative articles
  • /bitwize-music:researchers-security - Malware analysis, CVEs
  • /bitwize-music:researchers-financial - SEC filings, market data
  • /bitwize-music:researchers-historical - Archives, timelines
  • /bitwize-music:researchers-biographical - Personal backgrounds
  • /bitwize-music:researchers-primary-source - Tweets, blogs, forums
  • /bitwize-music:researchers-verifier - Quality control, citation validation
  • /bitwize-music:verify-sources - Human source verification gate (required before generation)

Quality Control

  • /bitwize-music:lyric-reviewer - Pre-generation QC gate (14-point checklist)
  • /bitwize-music:pronunciation-specialist - Scan for pronunciation risks
  • /bitwize-music:explicit-checker - Verify explicit content flags
  • /bitwize-music:plagiarism-checker - Check lyrics for phrases matching existing songs
  • /bitwize-music:voice-checker - Detect AI-written patterns in lyrics and prose
  • /bitwize-music:pre-generation-check - Final pre-generation checkpoint (6 gates)
  • /bitwize-music:validate-album - Validate album structure and paths

Production & Release

  • /bitwize-music:album-art-director - Visual concepts and AI art prompts
  • /bitwize-music:mix-engineer - Per-stem audio polish before mastering
  • /bitwize-music:mastering-engineer - Audio mastering guidance
  • /bitwize-music:promo-director - Generate promo videos for social media
  • /bitwize-music:promo-writer - Generate platform-specific social media copy
  • /bitwize-music:promo-reviewer - Review and polish promo copy before release
  • /bitwize-music:cloud-uploader - Upload promo videos to Cloudflare R2 or AWS S3
  • /bitwize-music:sheet-music-publisher - Convert audio to sheet music
  • /bitwize-music:release-director - Release coordination and distribution

File Management

  • /bitwize-music:import-track - Move track .md files to album location
  • /bitwize-music:import-audio - Move audio files to album location
  • /bitwize-music:import-art - Place album art in correct locations
  • /bitwize-music:rename - Rename an album or track (updates slugs and all paths)
  • /bitwize-music:clipboard - Copy track lyrics/prompts to clipboard

Workflow & Status

  • /bitwize-music:session-start - Run session startup procedure
  • /bitwize-music:next-step - Get recommended next action
  • /bitwize-music:album-dashboard - Visual album progress dashboard

System & Maintenance

  • /bitwize-music:configure - Edit plugin configuration
  • /bitwize-music:setup - Detect environment and install plugin dependencies
  • /bitwize-music:health-check - Check venv and skill registration health
  • /bitwize-music:test - Run automated tests
  • /bitwize-music:help - Show this help (you are here!)
  • /bitwize-music:about - About bitwize and the plugin

Common Workflows

Creating a New Album:

  1. /bitwize-music:new-album <name> <genre> - Create structure (or /bitwize-music:promote-idea "<idea title>" if the idea lives in IDEAS.md)
  2. Answer the 7 planning phases (concept, sonic direction, etc.)
  3. Write lyrics for each track
  4. Run /bitwize-music:lyric-reviewer before generation
  5. Generate in Suno, log results
  6. Polish stems with /bitwize-music:mix-engineer, then master with /bitwize-music:mastering-engineer
  7. [Optional] Generate promo videos with /bitwize-music:promo-director
  8. [Optional] Upload to cloud with /bitwize-music:cloud-uploader
  9. Release with /bitwize-music:release-director

True-Story Albums (with research):

  1. Use researcher skills to gather sources
  2. All sources must be verified by human before production
  3. Update track status from ❌ Pending to ✅ Verified (DATE)
  4. Then proceed with lyric writing and generation

Resume Existing Work:

  1. /bitwize-music:resume <album-name> - Get detailed status
  2. Follow the recommended next steps

Quick Tips

  • Config file: ~/.bitwize-music/config.yaml (always read this for paths)
  • Pronunciation: Use phonetic spelling for tricky words (see pronunciation guide)
  • Explicit content: Use flag for: fuck, shit, bitch, cunt, cock, dick, pussy, etc.
  • Mastering target: -14 LUFS, -1.0 dBTP for streaming platforms
  • Promo videos: Generate after mastering, 15s vertical (9:16) for social media
  • Track status flow: Not Started → In Progress → Generated → Final
  • Album status flow: Concept → In Progress → Complete → Released

Key Documentation

  • CLAUDE.md - Main workflow instructions
  • README.md - Project overview
  • ${CLAUDE_PLUGIN_ROOT}/reference/suno/ - Suno guides (best practices, model catalog), pronunciation, tips
  • ${CLAUDE_PLUGIN_ROOT}/reference/workflows/ - Detailed workflow procedures
  • ${CLAUDE_PLUGIN_ROOT}/reference/mastering/ - Audio mastering documentation
  • ${CLAUDE_PLUGIN_ROOT}/templates/ - Templates for new content
  • ${CLAUDE_PLUGIN_ROOT}/skills/[skill-name]/SKILL.md - Individual skill documentation

Getting Help

  • Use this skill anytime: /bitwize-music:help
  • For tutorial: /bitwize-music:tutorial
  • For status: /bitwize-music:resume <album-name>
  • Ask Claude: "What should I do next?" for guidance

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.