Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

18 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

中文文档

📝 This document is automatically generated and maintained by the GitHub Manager skill (AI-assisted). Do not edit manually — changes will be overwritten on the next update.


Suno Copilot

A Claude Code skill that translates user intent and reference song research into Suno-ready Lyrics, Exclude, and Style prompt outputs.

This is not a fully automated generator — it is a translation layer. Every output requires your manual approval before the skill proceeds to the next step.


Overview

Suno Copilot has two independent modes that share a memory-based song library:

Mode Command Purpose
Research /suno-copilot research Deep-analyze a reference song into a structured DNA file
Create /suno-copilot create Generate Lyrics + Exclude + Style from a DNA file and your intent

Features

  • Research mode: dispatches a subagent to gather lyrics, key, chords, BPM, production details, and critical descriptions. Guides a collaborative analysis session across 10 dimensions (5 Lyric DNA + 5 Sound DNA). You hold conclusion authority — Claude's analysis is a starting point, not a verdict.
  • Create mode: reads a DNA reference file and your intent, then produces three outputs in sequence — each gated by your explicit approval.
  • Embedded Suno knowledge base: style prompt mechanics, genre corpus risk, tag budget rules, lyric field mechanics, V4/V5 differences, and the Weirdness slider.
  • Genre corpus bypass: identifies non-generic targets (art-pop, deconstructed R&B, bedroom indie) and generates era-genre hybrids or production texture descriptors to navigate past mainstream corpus matching.
  • Metatag embedding: maps structure tags ([Verse], [Chorus], [Bridge]) and vocal delivery tags ([Whispered], [Belted], [Falsetto]) to lyrics. Warns against the unreliable [Intro] tag.
  • Exclude generation: 6-dimension exclude list at sub-type specificity — never category-level.

Installation

This skill requires Claude Code.

# Clone the repository
git clone https://github.com/hunterhigh/suno-copilot.git

# Copy the skill file into your Claude Code skills directory
cp suno-copilot/skills/suno-copilot.md ~/.claude/skills/

# Seed the memory directory
mkdir -p ~/.claude/projects/<your-project>/memory/suno-research

Or place skills/suno-copilot.md in any directory Claude Code is configured to load skills from.


Usage

Research a song

/suno-copilot research

You'll be prompted for the song name and artist (or you can paste lyrics directly). The skill:

  1. Dispatches a subagent to search for lyrics, key, chords, BPM, production details, and critical descriptions
  2. Presents findings for your review and correction
  3. Guides you through Lyric DNA analysis (structure, rhyme scheme, line breaks, imagery, metatag mapping)
  4. Guides you through Sound DNA analysis (melody, production, harmony, genre corpus assessment, open field)
  5. Saves the analysis to memory/suno-research/<artist>-<title>.md

Generate a track

/suno-copilot create

Specify a reference song (reads from the memory library) or proceed with intent only. The skill:

  1. Asks four intent questions: theme/emotion, core imagery, constraints, language
  2. Generates a Lyrics draft — loops with revisions until you approve
  3. Generates an Exclude list — 6 dimensions, sub-type specific — until you approve
  4. Generates a Style prompt — 9-layer build order, pre-presentation quality check — until you approve
  5. Presents the complete package: Lyrics + Exclude + Style

Project Structure

suno-copilot/
├── skills/
│   └── suno-copilot.md       # The skill — all workflow logic and Suno knowledge
└── memory/
    └── suno-research/
        └── .gitkeep           # Seeds the knowledge base directory

Song analysis files are written to memory/suno-research/ at runtime and are excluded from version control (personal data).


Requirements

  • Claude Code CLI or desktop app
  • A Claude account with access to Claude Sonnet or higher (subagent dispatch used in research mode)

License

MIT

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors