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

pronunciation-specialist — скилл для Claude Code

Скилл pronunciation-specialist сканирует тексты песен на слова, которые Suno может произнести неправильно, и предлагает фонетические исправления. Нужен при работе с именами, терминами и омографами.

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

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

Что делает pronunciation-specialist

Скилл проверяет текст песни на риски произношения: омографы, технические термины, акронимы, числа, имена и слова не на английском. Для найденных мест он показывает контекст, объясняет неоднозначность и предлагает фонетическое написание. Явные случаи вроде технических терминов исправляются автоматически, а для омографов и имён требуется подтверждение.

При работе с файлом трека скилл сначала проверяет, не является ли он инструментальным. Для вокального трека он может извлечь текст через extract_section, проверить омографы через check_homographs и затем подтвердить исправления через check_pronunciation_enforcement. Используется bitwize-music-mcp, а пользовательские записи произношения могут переопределять базовый справочник.

Скилл рассчитан на этап между lyric-writer и lyric-reviewer, поэтому lyric-writer нужен заранее. Если в тексте есть «live», «read» или другое слово с несколькими вариантами произношения, скилл остановится на уточнении, а не выберет вариант сам.

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

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

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

  • Запусти pronunciation-specialist для текста из tracks/neon.md и подготовь исправления для Suno.
  • Просканируй эти lyrics: «We live near the bass line» и уточни неоднозначные слова.
  • Проверь произношение в треке album_slug/track_slug, включая имена, числа и технические термины.

Как установить pronunciation-specialist

1Через Skills CLI (Vercel)

npx skills add bitwize-music-studio/claude-ai-music-skills --skill pronunciation-specialist -a claude-code

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

~/.claude/skills/pronunciation-specialist/SKILL.md

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

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

Вопросы о pronunciation-specialist

Как установить pronunciation-specialist в Claude Code?

Выполните npx skills add bitwize-music-studio/claude-ai-music-skills --skill pronunciation-specialist -a claude-code. После установки файл будет доступен по пути ~/.claude/skills/pronunciation-specialist/SKILL.md.

Что делает pronunciation-specialist?

Скилл ищет в lyrics слова с риском неправильного произношения для Suno и предлагает фонетические исправления. Он также формирует отчёт с контекстом и вариантами чтения.

Нужен ли pronunciation-specialist для инструментального трека?

Нет. При обнаружении instrumental: true или отметки Instrumental | Yes скилл прекращает проверку, потому что в треке нет текста для сканирования.

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

SKILL.md · CC0-1.0
---
name: pronunciation-specialist
description: Scans lyrics for pronunciation risks and prevents Suno mispronunciations. Use when writing lyrics with proper nouns, technical terms, homographs, or non-English words.
argument-hint: <track-file-path or paste lyrics to scan>
model: sonnet
effort: medium
prerequisites:
  - lyric-writer
allowed-tools:
  - Read
  - Edit
  - Write
  - Grep
  - Glob
  - bitwize-music-mcp
---

## Your Task

**Input**: $ARGUMENTS

### Instrumental Guard

When invoked with a track file path, **first check** the track's frontmatter for `instrumental: true` or the Track Details table for `**Instrumental** | Yes`. If the track is instrumental:
- **STOP** and report: "SKIP — Instrumental track (no lyrics to scan for pronunciation)"
- Do NOT scan instrumental tracks.

### Vocal Track Workflow

Based on the argument provided:
- **If given a track file path**: Read it, scan lyrics for pronunciation risks, report issues with fixes
- **If given lyrics directly**: Scan and flag risky words
- **Output**: Clean lyrics with all phonetic fixes applied, ready for suno-engineer

---

## Supporting Files

- **[word-lists.md](word-lists.md)** - Complete tables of homographs, tech terms, names, acronyms, numbers

---

# Pronunciation Specialist

Scan lyrics for pronunciation risks, suggest phonetic spellings, prevent Suno mispronunciations.

## Why This Matters

**The problem**: Suno AI guesses pronunciation. Wrong guess = wrong song = wasted generation.

**One wrong word ruins the take.**

## When to Invoke

**Always invoke between lyric-writer and lyric-reviewer:**

```
lyric-writer (WRITES + SUNO PROMPT) → pronunciation-specialist (RESOLVES) → lyric-reviewer (VERIFIES) → pre-generation-check
                                                  |
                                     Scan, resolve, fix risky words
```

**Your role — RESOLVE:**
- The lyric-writer flags potential pronunciation risks and asks about homographs
- You do the deep scan, resolve ambiguities with the user, and apply all phonetic fixes
- The lyric-reviewer then verifies all resolutions were correctly applied

---

## High-Risk Word Categories

See [word-lists.md](word-lists.md) for complete tables. Summary:

### 1. Homographs (CRITICAL)
Same spelling, different pronunciation. **ALWAYS require clarification.**
*(Canonical reference: `${CLAUDE_PLUGIN_ROOT}/reference/suno/pronunciation-guide.md`. Keep this summary in sync.)*

| Word | Options | Fix |
|------|---------|-----|
| live | LYVE (verb) / LIV (adjective) | "lyve" or "liv" |
| read | REED (present) / RED (past) | "reed" or "red" |
| lead | LEED (guide) / LED (metal) | "leed" or "led" |
| wind | WYND (air) / WINED (coil) | "wynd" or "wined" |
| tear | TEER (cry) / TARE (rip) | "teer" or "tare" |
| bass | BAYSS (music) / BASS (fish) | "bayss" or "bass" |

### 2. Tech Terms
Suno often mispronounces tech words:
- Linux → "Lin-ucks" (not "Line-ucks")
- SQL → "S-Q-L" or "sequel"
- API, CLI, SSH → spell out with hyphens

### 3. Names & Proper Nouns
Non-English names need phonetic spelling:
- Jose → "Ho-zay"
- Ramos → "Rah-mohs"
- Sinaloa → "Sin-ah-lo-ah"

### 4. Acronyms
3-letter acronyms → spell out with hyphens (FBI → F-B-I)
Word-like acronyms → phonetic (RICO → Ree-koh, NASA → Nah-sah)

### 5. Numbers
- Years: Use apostrophes ('93) or words (nineteen ninety-three)
- Digits: Write out (four-oh-four, not 404)

---

## Pronunciation Guides

You reference TWO pronunciation guides:

### Base Guide (Plugin-Maintained)
- **Location**: `${CLAUDE_PLUGIN_ROOT}/reference/suno/pronunciation-guide.md`
- **Contains**: Universal pronunciation rules, common homographs, tech terms
- **Updated**: By plugin maintainers when new issues are discovered

## Override Support

Check for custom pronunciation entries:

### Loading Override
1. Call `load_override("pronunciation-guide.md")` — returns override content if found (auto-resolves path from config)
2. If found: load and merge with base guide (override entries take precedence)
3. If not found: use base guide only (skip silently)

### Override File Format

**`{overrides}/pronunciation-guide.md`:**
```markdown
# Pronunciation Guide (Override)

## Artist Names
| Name | Pronunciation | Notes |
|------|---------------|-------|
| Ramos | Rah-mohs | Character name |

## Album-Specific Terms
| Term | Pronunciation | Notes |
|------|---------------|-------|
| Sinaloa | Sin-ah-lo-ah | Location |
```

### How to Use Override
- Add artist names, album-specific terms, and genre-specific jargon
- Override entries take precedence over base guide entries for the same word
- Base guide updates via plugin updates without conflicts
- Override guide is version-controlled with your music content

---

## Scanning Workflow

### Step 1: Automated Scan via MCP

1. Extract lyrics: `extract_section(album_slug, track_slug, "lyrics")`
2. Homograph scan: `check_homographs(lyrics_text)` — returns found homographs with line numbers, pronunciation options
3. Additional manual scan for tech terms, acronyms, numbers, and names (not covered by MCP homograph list) — cross-reference [word-lists.md](word-lists.md)
4. If style prompt exists: `scan_artist_names(style_text)` — catch blocklisted names

After fixes are applied:
5. Verify: `check_pronunciation_enforcement(album_slug, track_slug)` — confirms all pronunciation table entries appear in lyrics

### Step 2: Review Results

From MCP results and manual scan:
- Which words were flagged?
- What's the recommended fix for each?

### Step 3: Generate Report

For each flagged word, provide:
1. Line number and context
2. Why it's risky (ambiguity type)
3. Suggested phonetic spelling
4. Alternative if multiple pronunciations exist

**Example output**:
```
PRONUNCIATION RISKS FOUND (3):

Line V1:3 -> "We live in darknet spaces"
  Risk: "live" is homograph
  Options: "lyve" (verb) or "liv" (adjective)
  -> Needs clarification

Line C:1 -> "SQL injection in the code"
  Risk: "SQL" is tech acronym
  Fix: "S-Q-L" or "sequel"
  -> Auto-fix: "S-Q-L injection in the code"

Line V2:5 -> "Reading Linux logs at 3AM"
  Risk: "Linux" commonly mispronounced
  Fix: "Lin-ucks"
  -> Auto-fix: "Reading Lin-ucks logs at 3 A-M"
```

### Step 4: User Confirmation

**For ambiguous words (like "live")**: Ask user which pronunciation
**For clear fixes (tech terms)**: Auto-fix

---

## Auto-Fix Rules

### Always Auto-Fix
- Tech terms (SQL → S-Q-L, Linux → Lin-ucks)
- Common acronyms (FBI → F-B-I, GPS → G-P-S)
- Numbers (1993 → '93 or nineteen ninety-three)

### Ask User First
- Homographs (live, read, lead, wind, tear)
- Names (confirm pronunciation preference)
- Words with regional variants (data, either, route)

---

## Output Format

### Track File Updates

If given a track file, update these sections:

**Pronunciation Notes** (add table):
```markdown
| Word/Phrase | Phonetic | Notes |
|-------------|----------|-------|
| Jose Diaz | Ho-say Dee-ahz | Spanish name |
| live | lyve | Verb form (to reside) |
| SQL | S-Q-L | Spell out |
```

**Lyrics Box** (apply fixes):
Replace standard spelling with phonetic in the Suno lyrics section.

### Standalone Report

```
PRONUNCIATION SCAN COMPLETE
===========================
File: [path or "direct input"]
Risks found: X
Auto-fixed: Y
Needs user input: Z

FIXES APPLIED:
- "SQL" → "S-Q-L" (line V1:3)
- "Linux" → "Lin-ucks" (line V2:5)

NEEDS USER INPUT:
- "live" (line C:1) - lyve or liv?

CLEAN LYRICS:
[Full lyrics with all fixes applied]
```

---

## Adding Custom Pronunciations

When you discover new pronunciation issues specific to the user's content:

**Add to OVERRIDE guide** (`{overrides}/pronunciation-guide.md`):
1. Read config to get `paths.overrides` location
2. Check for `{overrides}/pronunciation-guide.md`
3. Create file if it doesn't exist (with header and table structure)
4. Add the word to appropriate section (Artist Terms, Album Names, etc.)
5. Include: word, standard spelling, phonetic spelling, notes

**Example entry:**
```markdown
| Larocca | larocca | Luh-rock-uh | Character in "sample-album" album |
```

**DO NOT** edit the base guide (`${CLAUDE_PLUGIN_ROOT}/reference/suno/pronunciation-guide.md`) - plugin updates will overwrite it.

**When to add:**
- Artist names, album titles, track titles
- Character names in documentary/narrative albums
- Location names specific to album content
- Any pronunciation discovered during production

This keeps discoveries version-controlled with the music content in the overrides directory.

---

## Remember

1. **Load both guides at start** - Base guide + override guide (if exists)
2. **Homographs are landmines** - live, read, lead, wind WILL mispronounce without fixes
3. **Tech terms need phonetic spelling** - Don't trust Suno with acronyms
4. **Non-English names always need help** - Phonetic spelling mandatory
5. **Numbers are tricky** - Write them out or use apostrophes
6. **When in doubt, ask** - Better to clarify than regenerate
7. **Add discoveries to OVERRIDE guide** - Never edit base guide (plugin will overwrite)

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

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

Все скиллы по теме «ИИ и ML» →
songwriting-and-ai-music Teknium (teknium1), Hermes Agent Скилл songwriting-and-ai-music помогает писать тексты песен, подбирать рифмы и составлять промпты для генератора Suno AI без упоминания имён защищённых артистов. CX Codex +1 649установок suno-song NeverSight Скилл suno-song превращает ссылку на YouTube, аудио, готовый текст или идею в промпт для Suno V5: размечает песню метатегами и держится в лимитах знаков. CX Codex +1 8установок lyric-diagnostic jwynia Скилл lyric-diagnostic ищет, почему текст песни звучит плоско или шаблонно, и разбирает его по шести параметрам: ритм, рифма, смысл, регистр, звук, структура. CX Codex +1 539установок ai-music-album nexu-io Скилл ai-music-album для Claude Code ведёт цикл создания музыкального альбома: от концепта и текстов до треклиста и экспорта. Включает работу над инди-релизами и брендовыми саундтреками. CX Codex +1 2 900установок producer-music acedatacloud Скилл producer-music генерирует музыку через AceDataCloud API: песни, тексты, каверы и инструментальные треки. Работает с продолжением, заменой фрагментов и разделением дорожек. CX Codex +1 236установок suno-music-creator Schwepps Скилл suno-music-creator ведёт агента по созданию треков и плейлистов в Suno AI V5 и Suno Studio: от брифа до экспорта. CX Codex +1 1 400установок

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

Весь набор →
mastering-engineer Скилл mastering-engineer для Claude Code сводит треки к нормам громкости платформ: измеряет LUFS и пики в WAV, обрабатывает и проверяет результат. Готовит отобранные треки к публикации. CX Codex +1 407установок mix-engineer Скилл mix-engineer обрабатывает отдельные стемы WAV из Suno: шумодав, EQ, компрессия, затем сборка в стерео WAV для мастеринга. CX Codex +1 402установок plagiarism-checker Скилл plagiarism-checker ищет в текстах песен фразы, которые могут случайно совпасть с чужими строками, и выдаёт отчёт с уровнями риска до релиза. CX Codex +1 391установок lyric-reviewer Скилл lyric-reviewer для Claude Code проверяет тексты песен перед генерацией в Suno. Находит проблемы с рифмой, просодией, произношением и структурой. CX Codex +1 360установок album-art-director Скилл album-art-director создаёт визуальные концепции обложек музыкальных релизов и генерирует готовые промпты для генераторов изображений. CX Codex +1 286установок 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установок

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

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