Reviews lyrics against a quality checklist before Suno generation.

CC0-1.0Auto-check passedEducation

Install Lyric Reviewer

skills CLI
$ npx skills add bitwize-music-studio/claude-ai-music-skills --skill lyric-reviewer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install bitwize-music-studio/claude-ai-music-skills lyric-reviewer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/bitwize-music-studio/claude-ai-music-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/lyric-reviewer .claude/skills/lyric-reviewer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
lyric-reviewer
GitHub stars
544
Token cost
~2.8k tokens
SKILL.md length
1,184 words
Files
2
Skills in repo
51
Repo updated
First seen
Licence
CC0-1.0

At a glance

Reviews lyrics against a quality checklist before Suno generation.

  • Works in 12 steps: Rhyme Check → Prosody Check → Pronunciation Check → …
  • Tasks that involve Language learning
  • SKILL.md covers Your Task, Supporting Files, The 14-Point Checklist and Auto-Fix Behavior, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Lyric Reviewer is an agent skill from bitwize-music-studio/claude-ai-music-skills. Reviews lyrics against a quality checklist before Suno generation. Use before generating tracks to catch rhyme, prosody, pronunciation, and structural issues.

Its SKILL.md is about 2.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `checklist-reference.md`).

It sits in Education, covering Language learning. It works with Suno. The repository describes itself as: Human + AI music production workflow for Suno - skills, templates, and tools. The licence is CC0-1.0.

When your agent uses it

  • Tasks that involve Language learning

Example prompts

  • “Use the lyric-reviewer skill to review lyrics against a quality checklist before Suno generation”
  • “/lyric-reviewer”

Requirements

  • Pre-approved tools (allowed-tools): Read, Edit, Glob, Grep, bitwize-music-mcp

Workflow steps

12 steps, taken from the step headings in SKILL.md.

  1. Rhyme Check
  2. Prosody Check
  3. Pronunciation Check
  4. POV/Tense Check
  5. Structure Check
  6. Flow Check
  7. Documentary Check (Conditional)
  8. Factual Check (Conditional)
  9. Length Check
  10. Section Length Check
  11. Rhyme Scheme Check
  12. Density/Pacing Check

What it can do on your machine

Read from SKILL.md and the folder at commit 58f32c2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Edit
    • Glob
    • Grep
    • bitwize-music-mcp

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Lyric Reviewer loads about 2.8k tokens when it runs. Until then it costs about 43 tokens; SKILL.md has 1,184 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~43
When it runs · the whole SKILL.md, loaded when a task matches
~2.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from bitwize-music-studio/claude-ai-music-skills at commit 58f32c2, republished under its CC0-1.0 licence (© bitwize-music-studio). 1,184 words, ~2,773 tokens.

Download SKILL.mdSave it as .claude/skills/lyric-reviewer/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
lyric-reviewer
description
Reviews lyrics against a quality checklist before Suno generation. Use before generating tracks to catch rhyme, prosody, pronunciation, and structural issues.
allowed-tools
Read, Edit, Glob, Grep, bitwize-music-mcp
argument-hint
<track-path | album-path | --fix>
model
opus
effort
max
prerequisites
lyric-writer, pronunciation-specialist

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


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

Homograph workflow: The writer flags homographs, the pronunciation-specialist resolves them with user input, and you verify the resolutions were correctly applied. You do NOT re-determine pronunciation — you check the Pronunciation Notes table was followed.


The 14-Point Checklist

1. Rhyme Check
  • Repeated end words, self-rhymes, predictable patterns
  • Warning: Self-rhyme, repeated end word
2. Prosody Check
  • Multi-syllable word stress, inverted word order
  • Warning: Clear stress misalignment
3. Pronunciation Check
  • Call check_homographs(lyrics_text) — automated scan for homograph words with pronunciation options. Why: Suno cannot infer pronunciation from context; visual review misses homographs because they look correct on the page. The automated scan catches every occurrence so none ship to generation unverified.
  • Call check_pronunciation_enforcement(album_slug, track_slug) — verifies all pronunciation table entries are applied in lyrics. Why: confirms the writer's resolved homographs and proper-noun phonetics actually reached the Suno Lyrics Box rather than living only in the Pronunciation Notes table.
  • Critical: Unphonetic proper noun, homograph detected (AUTO-FIX REQUIRED - see Homograph Detection section)
4. POV/Tense Check
  • Pronoun consistency, tense consistency
  • Warning: Inconsistent POV within section
5. Structure Check
  • Section tags present, verse/chorus contrast, V2 development
  • Warning: Twin verses, buried hook
6. Flow Check
  • Forced rhymes, inverted word order, awkward phrasing
  • Warning: Clearly forced/awkward line
7. Documentary Check (Conditional)
  • Only if RESEARCH.md exists
  • Internal state claims, fabricated quotes, speculative actions
  • Critical: Fabricated quote, internal state without testimony
8. Factual Check (Conditional)
  • Only if RESEARCH.md exists
  • Names, dates, numbers, events match sources
  • Critical: Wrong date/name/major fact
9. Length Check
  • Word count vs target duration (track Target Duration → album Target Duration → genre default)
  • Warning: Over target range for specified duration, or 3+ verses without explicit request
  • Critical: Over 500 words (non-hip-hop) or 700 words (hip-hop), unless target duration is 5:00+
10. Section Length Check
  • Count lines per section, compare against genre limits (see lyric-writer Section Length Limits)
  • Hard fail: Any section exceeding its genre max must be flagged for trimming
11. Rhyme Scheme Check
  • Verify rhyme scheme matches the genre (see lyric-writer Default Rhyme Schemes by Genre)
  • No orphan lines, no random scheme switches mid-verse
  • Warning: Inconsistent scheme within a section, orphan unrhymed line
12. Density/Pacing Check
  • Verse line count vs genre README's Density/pacing (Suno) default
  • Cross-reference BPM/mood from Musical Direction
  • Hard fail: Any verse exceeding the genre's max line count
13. Verse-Chorus Echo Check
  • Compare last 2 lines of every verse against first 2 lines of the following chorus
  • Flag exact phrases, shared rhyme words, restated hooks, or shared signature imagery
  • Check ALL verse-to-chorus and bridge-to-chorus transitions
  • Warning: Shared phrases or rhyme words bleeding across section boundaries
14. Artist Name Check
  • Call scan_artist_names(text) — scans lyrics AND style prompt against the artist blocklist
  • Critical: Any artist name in the style prompt will cause Suno to fail or produce unexpected results
  • Fix: Replace with genre/style description from the blocklist's "Say Instead" column

See checklist-reference.md for detailed criteria.


Auto-Fix Behavior

Always Auto-Applied (no flag needed)

Pronunciation in Lyrics Box

  • If Pronunciation Notes table has phonetic version
  • Replace standard spelling with phonetic in Lyrics Box
  • This always happens - pronunciation is critical for Suno
With --fix flag

Explicit Flag

  • Scan lyrics for explicit words
  • Correct flag if mismatched
Will NOT Auto-Fix (needs human judgment)
  • Rhyme issues
  • Prosody problems
  • Twin verses
  • Documentary issues
  • Flow/phrasing
Show full SKILL.md (473 more words)Show less
Homograph Verification (MANDATORY)

The lyric-writer asks the user to resolve homographs during writing. Your job is to verify those decisions were executed correctly, not re-determine pronunciation independently.

When you detect a homograph (live, read, lead, wind, tear, bass, bow, etc.):

  1. Check if the word has an entry in the Pronunciation Notes table
  2. If resolved: Verify the phonetic spelling from the table is applied in the Suno Lyrics Box (not just documented)
  3. If missing: Flag as "Unresolved homograph — needs user decision" (do NOT guess the pronunciation)
  4. Verify streaming lyrics keep standard spelling (phonetics are Suno-only)
  5. Report each homograph as "Verified ✓" or "Unresolved — ask user"

Anti-pattern: Determining pronunciation from context is WRONG. Suno cannot infer from context. Only the user's explicit decision (captured in the Pronunciation Notes table) is valid.

Common Homograph Fixes

(Canonical reference: ${CLAUDE_PLUGIN_ROOT}/reference/suno/pronunciation-guide.md. Keep this table in sync.)

WordContext ASpellingContext BSpelling
liveverb (to live)livadjective (live show)lyve
readpresent tensereedpast tensered
leadverb (to lead)leednoun (metal)led
windnoun (air)windverb (to wind)wynd
tearnoun (crying)teerverb (to rip)tare
bassnoun (fish)bassnoun (music)bayss
bownoun (ribbon)bohverb (to bow)bow
closeverb (to close)clozeadjective (near)close

Verification Report Format

markdown
# Lyric Review Report

**Album**: [name]
**Tracks reviewed**: X
**Date**: YYYY-MM-DD

---

## Executive Summary

- **Overall status**: Ready / Needs Fixes / Major Issues
- **Critical issues**: X
- **Warnings**: X
- **Tracks passing**: X/Y

---

## Critical Issues (Must Fix)

### Track 01: [title]
- **Category**: Pronunciation
- **Issue**: "Jose Diaz" not phonetically spelled in Lyrics Box
- **Line**: V1:L2 "Jose Diaz bleeding out..."
- **Fix**: Change to "Ho-say Dee-ahz bleeding out..."

---

## Warnings (Should Fix)

### Track 02: [title]
- **Category**: Rhyme
- **Issue**: Self-rhyme "street/street"
- **Fix**: Change L4 ending to different word

---

## Auto-Fix Applied

### Pronunciation Fixes
- Track 01: "Jose Diaz" → "Ho-say Dee-ahz" (applied)

---

## Ready for Suno?

**YES** - All critical issues resolved
**NO** - Critical issues remain

Severity Definitions

LevelDefinitionAction Required
CriticalWill cause Suno problems or legal riskMust fix before generation
WarningQuality issue, impacts songShould fix, can proceed with caution
InfoNitpick, optional improvementNice to have, not blocking

Quality Bar

Before marking "Ready for Suno":

  • Zero critical issues
  • All pronunciation notes applied to Lyrics Box
  • No unresolved homographs
  • Word count within genre target range
  • For documentary: No internal state claims, no fabricated quotes
  • Warnings documented (can proceed with caution)

If any critical issue remains: NOT ready for generation


Integration Points

Before This Skill
  • lyric-writer - creates/revises lyrics and auto-invokes suno-engineer for style prompt
  • pronunciation-specialist - resolves pronunciation issues with phonetic fixes
After This Skill
  • pre-generation-check - validates all gates before Suno generation
  • pronunciation-specialist - deep pronunciation analysis
  • explicit-checker - explicit content scanning
  • researchers-verifier - source verification for documentary albums

Remember

  1. Output is a verification report, not revised lyrics - Identify issues and propose fixes; let the lyric-writer or user apply rewrites. Auto-fixes are limited to pronunciation substitutions where the Notes table already holds the user-approved phonetic.
  2. Always apply pronunciation fixes - Don't just report them, fix them in the Lyrics Box
  3. Homographs are landmines - live, read, lead, wind will mispronounce
  4. Documentary = legal risk - Take internal state claims seriously
  5. Report format matters - Structured output helps track issues across albums
  6. Homographs need user decisions - If a homograph is missing from the Pronunciation Notes table, flag it as "Unresolved — needs user decision" (do NOT guess or auto-fix)

Your deliverable: Verification report with applied pronunciation fixes, remaining issues, and warnings.

© bitwize-music-studio, CC0-1.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/lyric-reviewer of bitwize-music-studio/claude-ai-music-skills.

  • SKILL.md
  • checklist-reference.md

Open the folder on GitHubat commit 58f32c2

Compare with similar skills

Lyric Reviewer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Lyric Reviewer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Lyric Reviewer this skillbitwize-music-studio/claude-ai-music-skills544—~2.8kAutomated safety check: PassCC0-1.0
Fluent Progressm98/fluent421—~1.5kAutomated safety check: NotesMIT
Fluent Sm2 Calculatorm98/fluent421—~1.2kAutomated safety check: PassMIT
Duolingo Playpockebot/openpocket847—~1.1kAutomated safety check: PassMIT
Study Companion Enmingchen666/Reviva244—~5.7kAutomated safety check: PassNone
Fluent Learnm98/fluent421—~1.8kAutomated safety check: NotesMIT

Similar skills

  • Fluent Progress

    m98/fluent

    Show the learner's language learning progress, statistics, mastery levels, streak, and achievements.

    421 GitHub stars~1.5k tokensUpdated 3 mo ago
    EducationAuto-check: notes
  • SM-2 spaced-repetition algorithm reference for the Fluent language learning system.

    421 GitHub stars~1.2k tokensUpdated 3 mo ago
    EducationAuto-check passed
  • Duolingo Play

    pockebot/openpocket

    Help users complete Duolingo language lessons. An agent skill from pockebot/openpocket.

    847 GitHub stars~1.1k tokensUpdated 3 mo ago
    EducationAuto-check passed
  • Study Companion En

    mingchen666/Reviva

    General study companion for learning, review, exam prep, exam-point analysis, syllabus/exam-outline interpretation, finals speedrun teaching, concept explanation, problem solving, homework coaching…

    244 GitHub stars~5.7k tokensUpdated yesterday
    EducationAuto-check passed
  • Fluent Learn

    m98/fluent

    Main adaptive language-learning session that mixes skills (writing, speaking, vocabulary, reading) and exercise types based on the learner's current level, weak patterns, and due reviews.

    421 GitHub stars~1.8k tokensUpdated 3 mo ago
    EducationAuto-check: notes
  • Fluent Reading

    m98/fluent

    Run an interactive reading comprehension session with a short target-language text followed by main-idea, detail, vocabulary-in-context, inference, and true/false questions.

    421 GitHub stars~1.8k tokensUpdated 3 mo ago
    EducationAuto-check: notes

More from bitwize-music-studio/claude-ai-music-skills

All 51 skills in this repo
  • Album Conceptualizer

    bitwize-music-studio/claude-ai-music-skills

    Designs album concepts, tracklist architecture, and thematic planning through 7 structured phases.

    544 GitHub stars~3.6k tokensUpdated 3 days ago
    Auto-check passed
  • Album Dashboard

    bitwize-music-studio/claude-ai-music-skills

    Shows a structured progress dashboard for an album with percentage complete per phase, blocking items, and status breakdown.

    544 GitHub stars~1.1k tokensUpdated 3 days ago
    Auto-check passed
  • Album Ideas

    bitwize-music-studio/claude-ai-music-skills

    Tracks and manages album ideas including brainstorming, planning, and status updates.

    544 GitHub stars~2.2k tokensUpdated 3 days ago
    Auto-check passed
  • Clipboard

    bitwize-music-studio/claude-ai-music-skills

    Copies track content (lyrics, style prompts, streaming lyrics) to the system clipboard.

    544 GitHub stars~1.4k tokensUpdated 3 days ago
    Auto-check: notes
  • Cloud Uploader

    bitwize-music-studio/claude-ai-music-skills

    Uploads promo videos and content to Cloudflare R2 or AWS S3.

    544 GitHub stars~2.1k tokensUpdated 3 days ago
    Auto-check: notes
  • Configure

    bitwize-music-studio/claude-ai-music-skills

    Sets up or edits the plugin configuration file interactively.

    544 GitHub stars~2.2k tokensUpdated 3 days ago
    Auto-check: notes

Works with

Categories

Questions about Lyric Reviewer

What does Lyric Reviewer do?

Reviews lyrics against a quality checklist before Suno generation. Lyric Reviewer is an agent skill from bitwize-music-studio/claude-ai-music-skills. Reviews lyrics against a quality checklist before Suno generation.

When should I use Lyric Reviewer?

Lyric Reviewer fits situations like: tasks that involve Language learning.

How do I install Lyric Reviewer in Claude Code?

Run `npx skills add bitwize-music-studio/claude-ai-music-skills --skill lyric-reviewer -a claude-code`. Or copy the skill folder (skills/lyric-reviewer in bitwize-music-studio/claude-ai-music-skills) into .claude/skills/lyric-reviewer in your project. Claude Code loads it when a task matches its description.

How do I install Lyric Reviewer in Codex?

Run `npx skills add bitwize-music-studio/claude-ai-music-skills --skill lyric-reviewer -a codex`. Or copy the skill folder (skills/lyric-reviewer in bitwize-music-studio/claude-ai-music-skills) into .agents/skills/lyric-reviewer in your project. Codex loads it when a task matches its description.

Can I use Lyric Reviewer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add bitwize-music-studio/claude-ai-music-skills --skill lyric-reviewer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/lyric-reviewer, .gemini/skills/lyric-reviewer, .github/skills/lyric-reviewer and .opencode/skills/lyric-reviewer in your project.

What does Lyric Reviewer need to run?

SKILL.md names no scripts, command-line tools or credentials: Lyric Reviewer is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Edit, Glob, Grep, bitwize-music-mcp.

Does Lyric Reviewer access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Lyric Reviewer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Lyric Reviewer use?

Lyric Reviewer is published under the CC0-1.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Lyric Reviewer use?

About 2.8k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Lyric Reviewer?

Skills that share tags, products or a category with Lyric Reviewer: Fluent Progress (m98/fluent, 421 stars), Fluent Sm2 Calculator (m98/fluent, 421 stars), Duolingo Play (pockebot/openpocket, 847 stars) and Study Companion En (mingchen666/Reviva, 244 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Lyric Reviewer?

bitwize-music-studio (a GitHub organization) maintains it in bitwize-music-studio/claude-ai-music-skills, which has 544 GitHub stars. The repository holds 51 skills in this directory. The repository was last updated on October 7, 2026.

Source: bitwize-music-studio/claude-ai-music-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.