Step 2 Music & Analysis Skill
Complete all Step 2 artifacts for one project.
Required artifacts in projects/<project-id>/music/:
- •One
.mp3file - •
suno_prompt.txt - •
song_info.txt - •
analysis.json
Execute
- •Resolve project id (default
default). - •Ensure one MP3 exists in
projects/<project-id>/music/. - •Load and apply
references/suno-and-analysis-prompt-best-practices.md. - •Write
suno_prompt.txtwith final generation prompt text (music-only language). - •Write
song_info.txtwith duration/BPM/structure notes. - •If using another AI to generate analysis content, require strict JSON-only output matching required keys.
- •Write
analysis.jsonwith required fields:- •
version - •
duration - •
bpm - •
sections
- •
Prompt quality checks
Before final save:
- •Suno prompt includes genre/mood/tempo/instrumentation/structure details.
- •Suno prompt excludes visual/camera language.
- •Analysis prompt (if used) requests JSON-only output and required keys.
Completeness check
Run:
bash
project=default
ls -1 "projects/$project/music"
node -e 'const fs=require("fs");const p="projects/default/music/analysis.json";const j=JSON.parse(fs.readFileSync(p,"utf8"));const req=["version","duration","bpm","sections"];const miss=req.filter(k=>!(k in j));if(miss.length){console.error("Missing:",miss.join(","));process.exit(1)}console.log("analysis.json schema keys ok")'
Mark Step 2 complete only when all four artifacts are present and non-empty.