# Pronunciation Specialist

Scans lyrics for pronunciation risks and prevents Suno mispronunciations.

- Repository: https://github.com/bitwize-music-studio/claude-ai-music-skills (615 stars)
- Category: Writing
- License: CC0-1.0
- Last updated: 2026-10-28
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add bitwize-music-studio/claude-ai-music-skills --skill pronunciation-specialist -g -a claude-code -y`
Codex: `npx skills add bitwize-music-studio/claude-ai-music-skills --skill pronunciation-specialist -g -a codex -y`
Cursor: `npx skills add bitwize-music-studio/claude-ai-music-skills --skill pronunciation-specialist -g -a cursor -y`
Gemini CLI: `npx skills add bitwize-music-studio/claude-ai-music-skills --skill pronunciation-specialist -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add bitwize-music-studio/claude-ai-music-skills`

## Description

Scans lyrics for pronunciation risks and prevents Suno mispronunciations. Use when writing lyrics with proper nouns, technical terms, homographs, or non-English words.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

## 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:

The rest: https://github.com/bitwize-music-studio/claude-ai-music-skills/blob/HEAD/skills/pronunciation-specialist/SKILL.md