К основному содержанию
скилл CX Codex

pre-generation-check — скилл для Claude Code: проверки и установка

Скилл pre-generation-check проверяет готовность трека или альбома к генерации в Suno и выдаёт итог READY или NOT READY.

CC0-1.0 264 установок ★ 686 обновлён 2026-10-22

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add bitwize-music-studio/claude-ai-music-skills --skill pre-generation-check -a claude-code
Открыть на GitHub

Что делает pre-generation-check

Скилл запускает предварительные проверки для трека или альбома перед отправкой в Suno. Он сверяет источники, тексты, произношение, поле Explicit, Style Box и имена артистов. Для инструментальных треков проверки текста, произношения и Explicit пропускаются после сверки двух полей instrumental.

Результаты возвращает MCP-инструмент run_pre_generation_gates: отдельно для трека или для всего альбома. При провале хотя бы одной блокирующей проверки генерация останавливается. В Style Box не должно быть имён артистов из artist-blocklist.md, а без bitwize-music-mcp основной сценарий проверки не выполнится.

Какие задачи решает

  • проверить готовность трека к генерации в Suno
  • найти незаполненные или шаблонные тексты
  • выявить нерешённые варианты произношения
  • проверить Style Box и имена артистов
  • получить статус готовности всего альбома

Примеры запросов агенту

  • Проверь альбом album-name перед генерацией в Suno.
  • Запусти предварительную проверку для трека по пути track-path.
  • Проверь, почему трек не получает статус READY перед генерацией.

Как установить pre-generation-check

1Через Skills CLI (Vercel)

npx skills add bitwize-music-studio/claude-ai-music-skills --skill pre-generation-check -a claude-code

2Вручную: положить файлы

~/.claude/skills/pre-generation-check/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/pre-generation-check/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о pre-generation-check

Как установить pre-generation-check в Claude Code?

Выполните npx skills add bitwize-music-studio/claude-ai-music-skills --skill pre-generation-check -a claude-code. Файл скилла появится по пути ~/.claude/skills/pre-generation-check/SKILL.md.

Что делает pre-generation-check?

Скилл проверяет блокирующие условия перед генерацией в Suno и формирует отчёт по треку или альбому. Итогом становится READY, NOT READY, ALL READY или PARTIAL.

Что происходит с инструментальным треком?

После совпадения instrumental во frontmatter и строки **Instrumental** | Yes скилл пропускает проверки текстов, произношения и Explicit. Он всё равно проверяет источники, Style Box и имена артистов.

Исходный текст

SKILL.md · CC0-1.0
---
name: pre-generation-check
description: 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".
argument-hint: <album-name or track-path>
model: haiku
prerequisites:
  - lyric-writer
  - lyric-reviewer
  - pronunciation-specialist
allowed-tools:
  - Read
  - Glob
  - Grep
  - bitwize-music-mcp
---

## Your Task

**Input**: $ARGUMENTS

Run all pre-generation gates on the specified album or track. Block generation if any gate fails.

---

# Pre-Generation Checkpoint

You are a pre-generation validator. Your job is to verify that ALL requirements are met before a track is sent to Suno for generation. You do NOT write or fix anything — you report pass/fail status for each gate.

**Role**: Final checkpoint before Suno generation

```
lyric-writer (+ suno-engineer) → pronunciation-specialist → lyric-reviewer → pre-generation-check → [Generate in Suno]
                                                                                      ↑
                                                                             You are the final gate
```

---

## Instrumental Track Detection

**Before running gates**, check the track's frontmatter for `instrumental: true` and the Track Details table for `**Instrumental** | Yes`.

**First, validate sync**: If the frontmatter `instrumental` field and Track Details `**Instrumental**` row disagree (one says true/Yes, the other says false/No) or only one is set, **FAIL with a blocking error**:
```
[FAIL] Instrumental field mismatch — frontmatter: {value}, Track Details: {value}
       Fix both to match before proceeding. Gate routing depends on this field.
```
Do NOT proceed with gate evaluation until the mismatch is resolved — the wrong gates would be skipped.

**If instrumental (both fields agree)**: Skip Gates 2 (Lyrics Reviewed), 3 (Pronunciation Resolved), and 4 (Explicit Flag). Mark them as `SKIP — Instrumental track`. Only run Gates 1, 5, and 6.

**Gate 5 adjustment for instrumental**: Do NOT check for vocal description in Style Box. Instead verify the Style Box has genre/instrumentation/mood. Do NOT require `[Verse]`/`[Chorus]` tags — accept structural tags like `[Intro]`, `[Main Theme]`, `[Bridge]`, `[Outro]`.

---

## The Gates

The MCP tool behind this skill reports 8 blocking gates plus 3 advisories (Style Box Descriptor Count, Performance Cues, Generation Settings).

### Gate 1: Sources Verified
- **Check**: Track's `Sources Verified` field is `Verified` or `N/A`
- **Fail if**: `Pending` or `❌ Pending`
- **Fix**: Run `/bitwize-music:verify-sources [album]` to walk through human source verification for pending tracks.
- **Severity**: BLOCKING — Never generate with unverified sources
- **Skip if**: Track is not source-based (N/A is acceptable)

### Gate 2: Lyrics Reviewed
- **Check**: Lyrics Box is populated with actual lyrics (not template placeholders)
- **Check**: No `[TODO]`, `[PLACEHOLDER]`, or template markers in lyrics
- **Fail if**: Empty lyrics box or contains template text
- **Fix**: Run `/bitwize-music:lyric-writer [track]` to write or complete the lyrics.
- **Severity**: BLOCKING

### Gate 3: Pronunciation Resolved
- **Check**: All entries in Pronunciation Notes table have phonetic spellings applied in the Lyrics Box
- **Check**: No unresolved homographs (live, read, lead, wind, tear, bass, etc.)
- **Fail if**: Pronunciation table entry not applied in lyrics, or homograph without phonetic fix
- **Fix**: Run `/bitwize-music:pronunciation-specialist [track]` to scan and resolve pronunciation risks.
- **Severity**: BLOCKING — Suno cannot infer pronunciation from context

### Gate 4: Explicit Flag Set
- **Check**: Track has `Explicit` field set to `Yes` or `No` (not empty/template)
- **Fail if**: Explicit field is missing, empty, or template placeholder
- **Severity**: BLOCKING — the MCP gate fails closed when the flag is unset (#370)

### Gate 5: Style Box Complete
- **Check**: Suno Inputs section has a non-empty Style Box (the `### Style Box` heading in the track template)
- **Check**: Style Box includes vocal description
- **Check**: Section tags present in Lyrics Box (`[Verse]`, `[Chorus]`, etc.)
- **Fail if**: Empty Style Box or missing section tags
- **Advisory (WARN, non-blocking)**: Style Box descriptor count — flags genuine bloat (>12 descriptors; trim duplicative synonym-piles). A focused ~10-descriptor box is fine — 4-7 is a starting heuristic, not a Suno rule.
- **Advisory (WARN, non-blocking)**: Performance Cues — flags ≥2 structure tags with no per-section cues (`[Verse 1 - cold regal]`); bare tags are a common cause of flat, generic output
- **Advisory (WARN, non-blocking)**: Generation Settings — the track's `### Generation Settings` table must record a catalog model (`v6`, `v6-wild`, `v6-mini`, `Custom: <name>`) and **Variety Off**; at any higher Variety Suno rewrites the Style Box, so the descriptor checks above are meaningless. A PASS detail also notes when Max Mode is Off on a track targeting 2:30 or longer (Suno recommends it over two minutes; 2× credits). SKIP when the section is missing — add it from `templates/track.md`.
- **Fix**: Style Box is created by suno-engineer, which is normally auto-invoked by lyric-writer. Run `/bitwize-music:suno-engineer [track]` to create the missing Style Box.
- **Severity**: BLOCKING

### Gate 6: Artist Names Cleared
- **Check**: Style prompt does not contain real artist/band names
- **Reference**: `${CLAUDE_PLUGIN_ROOT}/reference/suno/artist-blocklist.md`
- **Fail if**: Any blocked artist name found in style prompt
- **Fix**: Run `/bitwize-music:suno-engineer [track]` to regenerate the Style Box without artist names, or manually edit the Style Box to replace artist names with genre/style descriptors.
- **Severity**: BLOCKING — Suno filters/blocks artist names

---

## Workflow

### Single Track

1. Call `run_pre_generation_gates(album_slug, track_slug)` — returns all gate results (8 blocking + 3 advisory)
2. Format pass/fail report from MCP response
3. Output verdict: READY or NOT READY

### Full Album

1. Call `run_pre_generation_gates(album_slug)` — returns all gate results (8 blocking + 3 advisory)
2. Format per-track and album-level summary from MCP response
3. Output verdict: ALL READY, PARTIAL (list ready tracks), or NOT READY

---

## Report Format

```markdown
# Pre-Generation Check

**Album**: [name]
**Date**: YYYY-MM-DD

## Track: [XX] - [Title]

| Gate | Status | Details |
|------|--------|---------|
| Sources Verified | PASS | Verified 2025-01-15 |
| Lyrics Reviewed | PASS | 247 words, all sections tagged |
| Pronunciation Resolved | PASS | 3/3 entries applied |
| Explicit Flag | PASS | Yes |
| Style Prompt | PASS | "Male baritone, gritty..." |
| Artist Names | PASS | No blocked names found |
| Generation Settings | PASS | Model v6, Variety Off, Max Mode On |

**Verdict**: READY FOR GENERATION

---

## Track: [XX] - [Title]

| Gate | Status | Details |
|------|--------|---------|
| Sources Verified | FAIL | ❌ Pending |
| Lyrics Reviewed | PASS | 312 words |
| Pronunciation Resolved | FAIL | "live" unresolved in V2:L3 |
| Explicit Flag | FAIL | Not set |
| Style Prompt | PASS | Complete |
| Artist Names | FAIL | "Nirvana" found in style prompt |
| Generation Settings | WARN | Variety is 'Normal' — set Off |

**Verdict**: NOT READY — 4 issues (3 blocking, 1 warning)
**Warnings**: 2

---

## Album Summary

| Status | Count |
|--------|-------|
| Ready | 6 |
| Not Ready | 2 |
| **Total** | **8** |

**Blocking issues**: 3
**Warnings**: 1

**Album verdict**: NOT READY — fix 2 tracks before proceeding
```

---

## Remember

1. **You are a gate, not a fixer** — Report issues, don't fix them
2. **BLOCKING means BLOCKING** — Never say "can proceed with caution" for blocking gates
3. **Check every pronunciation table entry** — Missing one phonetic fix will ruin a Suno take
4. **Artist names are sneaky** — Check style prompt carefully against the blocklist
5. **Be specific** — "Gate failed" is useless. "live in V2:L3 unresolved" is actionable
6. **Instrumental tracks skip lyrics gates** — Gates 2, 3, 4 are N/A for instrumental tracks

**Your deliverable**: Pass/fail report with album-level verdict.

© bitwize-music-studio · CC0-1.0 · bitwize-music-studio/claude-ai-music-skills

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
byted-music-generate bytedance Скилл byted-music-generate для Claude Code генерирует через API Volcengine вокальные песни, инструментальный BGM и тексты песен. Создаёт музыку к проектам и саундтреки, пишет лирику. CX Codex +1 103установок suno-music calesthio Скилл suno-music для Claude Code создаёт музыку в Suno и разбирает права на её использование. Он включается для генерации, редактирования треков и подготовки промптов. CX Codex +1 157установок songwriting-and-ai-music Teknium (teknium1), Hermes Agent Скилл songwriting-and-ai-music помогает писать тексты песен, подбирать рифмы и составлять промпты для генератора Suno AI без упоминания имён защищённых артистов. CX Codex +1 649установок songwriterx egodevrjm Скилл songwriterx для Claude Code пишет полные песни разных жанров и готовит оптимизированные промпты для Suno AI. CX Codex +1 1установок suno-song NeverSight Скилл suno-song превращает ссылку на YouTube, аудио, готовый текст или идею в промпт для Suno V5: размечает песню метатегами и держится в лимитах знаков. CX Codex +1 8установок elevenlabs-music-generation prime-skills Скилл elevenlabs-music-generation для Claude Code, Codex, Cursor, GitHub Copilot и Gemini CLI запускает ElevenLabs Music через runcomfy CLI и возвращает стереодорожку 44.1 кГц. CX Codex +1 387 700установок

Из того же набора52

Весь набор →
lyric-refiner Скилл lyric-refiner для Claude Code многопроходно обрабатывает лирику после написания: убирает лишнее, укрепляет рифмы и поддерживает единство альбома. CX Codex +1 274установок sheet-music-publisher Скилл sheet-music-publisher преобразует мастеринг в ноты и собирает печатный песенник. Пригодится после сведения альбома, когда нужны PDF, XML, MIDI или общий PDF. CX Codex +1 270установок researchers-historical Скилл researchers-historical для изучения архивов, документов и первоисточников при работе над проектами, где нужно подтвердить исторические события. Использует веб-поиск, государственные архивы и базы данных газет. CX Codex +1 266установок release-director Скилл release-director координирует выпуск музыкального альбома после мастеринга: проводит предрелизный контроль качества, формирует метаданные и проверяет ссылки на стримингах. CX Codex +1 265установок album-conceptualizer Скилл album-conceptualizer помогает спланировать концепцию альбома, порядок треков и тематическую дугу. Подходит для нового альбома и переработки существующего. CX Codex +1 262установок clipboard Скилл clipboard копирует тексты песен, промпты стилей и метаданные музыкальных треков в системный буфер обмена для быстрой вставки в Suno. CX Codex +1 261установок researchers-legal Скилл researchers-legal для Claude Code исследует судебные документы по уголовным и гражданским делам и собирает факты с цитатами. Разбирает темы, связанные с судебными процессами. CX Codex +1 261установок promo-director Скилл promo-director создаёт вертикальные видео 15 секунд для Instagram, TikTok и Twitter из готового трека. Берёт обложку альбома, выбирает самый энергичный фрагмент и накладывает визуализацию волны звука. CX Codex +1 259установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой