New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Promote Idea

by bitwize-music-studio in bitwize-music-studio/claude-ai-music-skills

Converts an album idea from IDEAS.md into an actual album project in one step.

CC0-1.0Auto-check passed

Install Promote Idea

skills CLI
$ npx skills add bitwize-music-studio/claude-ai-music-skills --skill promote-idea -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install bitwize-music-studio/claude-ai-music-skills promote-idea --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/bitwize-music-studio/claude-ai-music-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/promote-idea .claude/skills/promote-idea && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
promote-idea
GitHub stars
544
Token cost
~1.7k tokens
SKILL.md length
589 words
Files
1
Skills in repo
51
Repo updated
First seen
Licence
CC0-1.0

At a glance

Converts an album idea from IDEAS.md into an actual album project in one step.

  • Works in 5 steps: Parse Arguments → Confirm the Derived Slug → Ask About Documentary Flag (if not… → …
  • The user says promote [idea title]
  • SKILL.md covers Your Task, Step 1: Parse Arguments, Step 2: Confirm the Derived Slug and Step 3: Ask About Documentary…, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Promote Idea is an agent skill from bitwize-music-studio/claude-ai-music-skills. 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]".

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Human + AI music production workflow for Suno - skills, templates, and tools. The licence is CC0-1.0.

When your agent uses it

  • The user says promote [idea title]
  • Turn idea into album
  • Start working on [idea]

Example prompts

  • “promote [idea title]”
  • “turn idea into album”
  • “start working on [idea]”
  • “/promote-idea”

Requirements

  • Pre-approved tools (allowed-tools): Read, bitwize-music-mcp

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Parse Arguments
  2. Confirm the Derived Slug
  3. Ask About Documentary Flag (if not already supplied)
  4. Promote via MCP
  5. Confirm and Suggest Next Step

What it can do on your machine

Read from SKILL.md and the folder at commit 58f32c2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • bitwize-music-mcp

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Promote Idea loads about 1.7k tokens when it runs. Until then it costs about 48 tokens; SKILL.md has 589 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~48
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from bitwize-music-studio/claude-ai-music-skills at commit 58f32c2, republished under its CC0-1.0 licence (© bitwize-music-studio). 589 words, ~1,687 tokens.

Download SKILL.mdSave it as .claude/skills/promote-idea/SKILL.md (or your agent's skills folder).
name
promote-idea
description
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]".
allowed-tools
Read, bitwize-music-mcp
argument-hint
<"idea title"> [album-slug-override]
model
haiku

Your Task

Input: $ARGUMENTS

Convert a Pending idea from IDEAS.md into a full album project in one call. Replaces the manual 3-step workflow (get_ideas → new-album → update_idea) with a single entry point.

Promote Idea Skill

Step 1: Parse Arguments

Expected formats:

  • "<idea title>" — auto-derive slug from the title
  • "<idea title>" <album-slug> — override the auto-derived slug
  • "<idea title>" documentary — standard slug, documentary flag on
  • "<idea title>" <album-slug> documentary — explicit slug + documentary

Examples:

  • "Kleine Welt" → slug auto-derived to kleine-welt
  • "The Great Molasses Flood" molasses-flood documentary
  • "Ängstliche Kätzchen" → slug angstliche-katzchen (diacritics stripped)

If no arguments are supplied, or the title is empty, list the available pending ideas first and ask which one to promote:

Which idea should I promote?

Pending ideas:
1. Kleine Welt (electronic, Thematic)
2. The Great Molasses Flood (folk, Documentary)
3. Linux Kernel Wars (electronic, Character Study)

Reply with the exact title.

Use get_ideas(status_filter="Pending") to fetch the list.

Step 2: Confirm the Derived Slug

Call get_ideas(status_filter="Pending") (or search(query=idea_title, scope="ideas")) to confirm the idea exists and show the user what's about to happen.

Compute the slug locally for display only (lowercase, strip diacritics, non-alphanumeric → hyphen). If the result looks odd, offer to override:

About to promote:
  Idea:  Kleine Welt
  Slug:  kleine-welt
  Genre: electronic
  Type:  Thematic

Proceed? (Or supply a different slug.)

Skip the confirmation step if the user has already provided an explicit slug — that's the signal they've already thought about it.

Step 3: Ask About Documentary Flag (if not already supplied)

The documentary flag decides whether RESEARCH.md and SOURCES.md are created. This is not derivable from idea metadata — the idea's "Type" field can say "Documentary" but that's a separate concept (narrative shape). Ask once:

Is this a documentary/true-story album? (Adds research + sources templates. Answer 'yes' for real-world events, 'no' for fiction.)

Skip this step if documentary is already in the arguments.

Step 4: Promote via MCP

Call promote_idea(idea_title, album_slug=<slug or "">, documentary=<bool>).

The tool performs all of:

  1. Find the idea in state (error if missing or already promoted)
  2. Create the album directory via create_album_structure
  3. Inject the idea's concept into the new README.md under a ## Concept section
  4. Advance idea status Pending → In Progress
  5. Add **Promoted To**: <slug> back-link to the idea in IDEAS.md

The tool returns {promoted: true, slug, album_path, files, ...} on success or {error: ...} on failure.

Step 5: Confirm and Suggest Next Step

On success, report:

Promoted "Kleine Welt" → album "kleine-welt"

Location: ~/bitwize-music/artists/bitwize/albums/electronic/kleine-welt/
Files:    README.md, tracks/

Concept block injected into README.md from idea.
Idea status: Pending → In Progress

Next step:
  /bitwize-music:album-conceptualizer

  This walks through the 7 Planning Phases (Vision, Identity, Sonic
  Direction, Structure, Tracks, Content, Approval) to develop the concept
  you just carried over into the album.

For documentary albums, add:

  Research files also created: RESEARCH.md, SOURCES.md
  Don't forget human source verification before generation.

Error Handling

Idea not found:

Error: Idea "Nonexistent" not found in IDEAS.md.

Check available ideas: /bitwize-music:album-ideas list

Idea already promoted:

Error: Idea "Already Active" is already promoted (status: In Progress).

If you want to rename or re-scaffold, use /bitwize-music:rename on the
existing album instead.

Idea has no genre:

Error: Idea "No Genre" has no **Genre** field in IDEAS.md.

Set the genre first: /bitwize-music:album-ideas edit "No Genre"

Invalid genre:

Error: Invalid genre "xyz" on idea. Not in genres/.

Fix the genre in IDEAS.md, then retry.

Duplicate album slug:

Error: Album "kleine-welt" already exists.

Options:
1. Supply a different slug: /bitwize-music:promote-idea "Kleine Welt" kleine-welt-2
2. Resume the existing album: /bitwize-music:resume kleine-welt
Show full SKILL.md (228 more words)Show less

Examples

Simple title
/bitwize-music:promote-idea "Kleine Welt"

Auto-derives slug kleine-welt, asks about documentary flag, calls promote_idea, reports outcome.

Explicit slug override
/bitwize-music:promote-idea "The Great Molasses Flood" molasses-1919

Uses molasses-1919 instead of the auto-derived the-great-molasses-flood.

Documentary album
/bitwize-music:promote-idea "The Great Molasses Flood" documentary

Creates RESEARCH.md and SOURCES.md in addition to the standard README and tracks directory.

Why a Dedicated Skill

The manual workflow required three steps in sequence:

  1. get_ideas to find the idea's genre
  2. /bitwize-music:new-album <slug> <genre> with a slug the user invented
  3. update_idea("<title>", "status", "In Progress")

Problems this skill solves:

  • Concept transfer — The idea's concept text is now merged into the new album README automatically (manual copy/paste used to be skipped often).
  • Status discipline — Ideas no longer linger as Pending after being worked on; the transition is automatic and bidirectional (Promoted To back-link).
  • Slug derivation — No more re-inventing the slug; diacritics and punctuation are normalized consistently.
  • Single entry point — Newcomers learn one command instead of three.

Remember

  1. Pending-only — Only Pending ideas can be promoted. In Progress and Complete ideas return an error.
  2. One-way operation — Promotion creates files and updates state. There is no "unpromote"; use /bitwize-music:rename or manual cleanup if you need to redo.
  3. Concept is preserved — The idea's concept survives in two places after promotion: the idea's entry in IDEAS.md (historical record) and the new album's README.md (working document).
  4. Next step is always album-conceptualizer — Promotion only scaffolds; the actual planning happens in the 7 Planning Phases.

© bitwize-music-studio, CC0-1.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/promote-idea of bitwize-music-studio/claude-ai-music-skills.

Open the folder on GitHubat commit 58f32c2

Compare with similar skills

Promote Idea next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Promote Idea compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Promote Idea this skillbitwize-music-studio/claude-ai-music-skills544—~1.7kAutomated safety check: PassCC0-1.0
Convertremotion-dev/remotion63k—~247Automated safety check: PassCustom licence
Promotealirezarezvani/claude-skills28k1 repos~1.1kAutomated safety check: PassMIT
Idea Darwinsickn33/agentic-awesome-skills47k2 repos~1.1kAutomated safety check: PassMIT
Idea Refinementaddyosmani/agent-skills105k6 repos~2kAutomated safety check: PassMIT
Same Idea Both Platformssickn33/agentic-awesome-skills47k1 repos~1.4kAutomated safety check: PassMIT

Similar skills

  • Convert

    remotion-dev/remotion

    Official

    Start the local @remotion/convert app and open it in the Codex browser.

    63k GitHub stars~247 tokensUpdated yesterday
    Media & CreativeAuto-check passed

  • Promote

    alirezarezvani/claude-skills

    Graduate a proven pattern from auto-memory (MEMORY.md) to CLAUDE.md or .claude/rules/ for permanent enforcement.

    28k GitHub starsUsed in 1 repo~1.1k tokens
    Agent WorkflowsAuto-check passed

  • Idea Darwin

    sickn33/agentic-awesome-skills

    Darwinian idea evolution engine — toss rough ideas onto an evolution island, let them compete, crossbreed, and mutate through structured rounds to surface your strongest concepts.

    47k GitHub starsUsed in 2 repos~1.1k tokens
    Auto-check passed

  • Idea Refinement

    addyosmani/agent-skills

    Guides a conversation that takes a vague idea through divergent and convergent thinking and ends in a markdown one-pager covering scope and assumptions.

    105k GitHub starsUsed in 6 repos~2k tokens
    Agent WorkflowsAuto-check passed

  • Same Idea Both Platforms

    sickn33/agentic-awesome-skills

    Write one idea as a Twitter/X post and a LinkedIn post that read as written separately, not pasted twice.

    47k GitHub starsUsed in 1 repo~1.4k tokens
    Writing & ContentAuto-check passed

  • Idea Evaluator

    sickn33/agentic-awesome-skills

    Evaluates an idea by hosting a multi-turn debate between a Pro and Con agent, delivering a final verdict on whether it's worth pursuing.

    47k GitHub starsUsed in 1 repo~930 tokens
    Auto-check passed

More from bitwize-music-studio/claude-ai-music-skills

All 51 skills in this repo

  • Album Conceptualizer

    bitwize-music-studio/claude-ai-music-skills

    Designs album concepts, tracklist architecture, and thematic planning through 7 structured phases.

    544 GitHub stars~3.6k tokensUpdated 3 days ago
    Auto-check passed

  • Album Dashboard

    bitwize-music-studio/claude-ai-music-skills

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

    544 GitHub stars~1.1k tokensUpdated 3 days ago
    Auto-check passed

  • Album Ideas

    bitwize-music-studio/claude-ai-music-skills

    Tracks and manages album ideas including brainstorming, planning, and status updates.

    544 GitHub stars~2.2k tokensUpdated 3 days ago
    Auto-check passed

  • Clipboard

    bitwize-music-studio/claude-ai-music-skills

    Copies track content (lyrics, style prompts, streaming lyrics) to the system clipboard.

    544 GitHub stars~1.4k tokensUpdated 3 days ago
    Auto-check: notes

  • Cloud Uploader

    bitwize-music-studio/claude-ai-music-skills

    Uploads promo videos and content to Cloudflare R2 or AWS S3.

    544 GitHub stars~2.1k tokensUpdated 3 days ago
    Auto-check: notes

  • Configure

    bitwize-music-studio/claude-ai-music-skills

    Sets up or edits the plugin configuration file interactively.

    544 GitHub stars~2.2k tokensUpdated 3 days ago
    Auto-check: notes

Questions about Promote Idea

What does Promote Idea do?

Converts an album idea from IDEAS.md into an actual album project in one step. Promote Idea is an agent skill from bitwize-music-studio/claude-ai-music-skills.md into an actual album project in one step.

When should I use Promote Idea?

Promote Idea fits situations like: the user says promote [idea title]; turn idea into album; start working on [idea].

How do I install Promote Idea in Claude Code?

Run `npx skills add bitwize-music-studio/claude-ai-music-skills --skill promote-idea -a claude-code`. Or copy the skill folder (skills/promote-idea in bitwize-music-studio/claude-ai-music-skills) into .claude/skills/promote-idea in your project. Claude Code loads it when a task matches its description.

How do I install Promote Idea in Codex?

Run `npx skills add bitwize-music-studio/claude-ai-music-skills --skill promote-idea -a codex`. Or copy the skill folder (skills/promote-idea in bitwize-music-studio/claude-ai-music-skills) into .agents/skills/promote-idea in your project. Codex loads it when a task matches its description.

Can I use Promote Idea in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add bitwize-music-studio/claude-ai-music-skills --skill promote-idea -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/promote-idea, .gemini/skills/promote-idea, .github/skills/promote-idea and .opencode/skills/promote-idea in your project.

What does Promote Idea need to run?

SKILL.md names no scripts, command-line tools or credentials: Promote Idea is instructions for the agent only. Its frontmatter pre-approves these tools: Read, bitwize-music-mcp.

Does Promote Idea access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Promote Idea safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Promote Idea use?

Promote Idea is published under the CC0-1.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Promote Idea use?

About 1.7k tokens (SKILL.md is roughly 6.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Promote Idea?

Skills that share tags, products or a category with Promote Idea: Convert (remotion-dev/remotion, 63k stars), Promote (alirezarezvani/claude-skills, 28k stars), Idea Darwin (sickn33/agentic-awesome-skills, 47k stars) and Idea Refinement (addyosmani/agent-skills, 105k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Promote Idea?

bitwize-music-studio (a GitHub organization) maintains it in bitwize-music-studio/claude-ai-music-skills, which has 544 GitHub stars. The repository holds 51 skills in this directory. The repository was last updated on October 7, 2026.

Source: bitwize-music-studio/claude-ai-music-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.