promote-idea — скилл для Claude Code: что делает и как установить
Скилл promote-idea для Claude Code переводит идею альбома из IDEAS.md в рабочий проект одной командой. Меняет статус идеи на In Progress.
CC0-1.0 188 установок ★ 686 обновлён 2026-10-22
npx skills add bitwize-music-studio/claude-ai-music-skills --skill promote-idea -a claude-codeЧто делает promote-idea
Скилл находит идею со статусом Pending, выводит её данные и готовит альбом. Он сам производит slug из названия или берёт переданный вариант, затем через bitwize-music-mcp создаёт структуру проекта, переносит концепцию в README.md и меняет статус на In Progress. В записи идеи появляется обратная ссылка Promoted To.
Для документального альбома флаг documentary добавляет RESEARCH.md и SOURCES.md. Без него создаются README.md и каталог tracks/. Скилл использует инструменты Read и bitwize-music-mcp, а для проверки ищет идеи через get_ideas или search.
Продвигать можно только идеи со статусом Pending. Операция односторонняя: отмены продвижения нет, поэтому повторную подготовку придётся делать через переименование или ручную очистку.
Какие задачи решает
- перенести концепцию идеи в
README.mdальбома - создать структуру альбомного проекта
- сменить статус идеи с
PendingнаIn Progress - получить slug из названия с нормализацией диакритики
- добавить обратную ссылку на созданный альбом
Примеры запросов агенту
- Выполни
/bitwize-music:promote-idea "Kleine Welt"и подготовь альбом. - Продвинь идею
The Great Molasses Floodсо slugmolasses-1919. - Создай документальный альбом из идеи
The Great Molasses Flood. Используй/bitwize-music:promote-idea "The Great Molasses Flood" documentary.
Как установить promote-idea
1Через Skills CLI (Vercel)
npx skills add bitwize-music-studio/claude-ai-music-skills --skill promote-idea -a claude-code2Вручную: положить файлы
~/.claude/skills/promote-idea/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/promote-idea/
1Через Skills CLI (Vercel)
npx skills add bitwize-music-studio/claude-ai-music-skills --skill promote-idea -a codex2Вручную: положить файлы
.agents/skills/promote-idea/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add bitwize-music-studio/claude-ai-music-skills --skill promote-idea -a cursor2Вручную: положить файлы
.cursor/skills/promote-idea/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install bitwize-music-studio/claude-ai-music-skills skills/promote-idea2Вручную: положить файлы
.github/skills/promote-idea/SKILL.md1Через Skills CLI (Vercel)
npx skills add bitwize-music-studio/claude-ai-music-skills --skill promote-idea -a gemini-cli2Командой платформы
gemini skills install https://github.com/bitwize-music-studio/claude-ai-music-skills --path skills/promote-ideaВручную: положить файлы
.devin/skills/promote-idea/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add bitwize-music-studio/claude-ai-music-skills --skill promote-idea -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о promote-idea
Как установить promote-idea в Claude Code?
Выполните npx skills add bitwize-music-studio/claude-ai-music-skills --skill promote-idea -a claude-code, затем используйте файл ~/.claude/skills/promote-idea/SKILL.md.
Что делает promote-idea?
Скилл превращает идею со статусом Pending из IDEAS.md в альбомный проект: создаёт файлы, переносит концепцию в README.md и обновляет статус идеи.
Что произойдёт с документальной идеей?
Флаг documentary создаёт в альбоме RESEARCH.md и SOURCES.md вместе со стандартными README.md и tracks/. Тип идеи Documentary сам по себе этот флаг не включает.
Исходный текст
SKILL.md · CC0-1.0
---
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]".
argument-hint: <"idea title"> [album-slug-override]
model: haiku
allowed-tools:
- Read
- bitwize-music-mcp
---
## 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
```
---
## 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 · bitwize-music-studio/claude-ai-music-skills