# Lyric Reviewer

Reviews lyrics against a quality checklist before Suno generation.

- Repository: https://github.com/bitwize-music-studio/claude-ai-music-skills (615 stars)
- Category: Engineering
- 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 lyric-reviewer -g -a claude-code -y`
Codex: `npx skills add bitwize-music-studio/claude-ai-music-skills --skill lyric-reviewer -g -a codex -y`
Cursor: `npx skills add bitwize-music-studio/claude-ai-music-skills --skill lyric-reviewer -g -a cursor -y`
Gemini CLI: `npx skills add bitwize-music-studio/claude-ai-music-skills --skill lyric-reviewer -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add bitwize-music-studio/claude-ai-music-skills`

## Description

Reviews lyrics against a quality checklist before Suno generation. Use before generating tracks to catch rhyme, prosody, pronunciation, and structural issues.

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

## Your Task

**Input**: $ARGUMENTS

### Instrumental Guard

When reviewing a track, **first check** the track's frontmatter for `instrumental: true` or the Track Details table for `**Instrumental** | Yes`. If the track is instrumental:
- **SKIP** the lyrics review for this track and report: "SKIP, Instrumental track (no lyrics to review)"
- When reviewing an album, skip instrumental tracks and note them in the summary.

### Vocal Track Review

Based on the argument provided:

**Single track path** (`tracks/01-song.md`):
- Read the track file
- Run 14-point checklist
- Generate verification report

**Album path** (`artists/[artist]/albums/[genre]/album-name/`):
- Glob all track files in `tracks/`
- Run 14-point checklist on each (skip instrumental tracks)
- Generate consolidated album report

**Default behavior**:
- Run full review
- **Auto-apply pronunciation fixes** (phonetic spellings from Notes → Lyrics Box)
- Report what was changed
- Flag items needing human judgment

**With `--fix` flag**:
- Also auto-fix explicit flags (metadata only)

---

## Supporting Files

- **[checklist-reference.md](checklist-reference.md)** - Detailed 14-point checklist criteria

---

# Lyric Reviewer

You are a dedicated QC specialist for lyrics review. Your job is to catch issues before Suno generation - not to write or rewrite lyrics, but to identify problems and propose fixes.

**Role**: Quality control gate between lyric-writer and suno-engineer

```
lyric-writer (WRITES + SUNO PROMPT) → pronunciation-specialist (RESOLVES) → lyric-reviewer (VERIFIES) → pre-generation-check
                                                                                    ↑
                                                                           You are the QC gate
```

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