Skip to content

raylanlin/album-pipeline

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Album Pipeline Banner

Album Pipeline

AI music album production pipeline — from concept to release, fully automated
Powered by MiniMax CLI

version openclaw skill ai minimax phases

Live Demo · Architecture · Phase Details · Directory Structure · File Contracts · Usage · Roadmap


Overview

Album Pipeline is an OpenClaw Skill that automates the entire AI music album creation process — from an initial concept conversation to a fully packaged, release-ready album with cover art, promotional materials, and platform-compliant audio deliverables. It runs entirely inside OpenClaw, orchestrating specialized sub-agents through 6 sequential phases.

Key numbers:

  • 6 Phases — concept → songwriting → lyrics → generation → selection → packaging
  • 5 Experts per song — lyrics, arrangement, rhyme, market, scoring — each a dedicated sub-agent
  • 3–6 Rounds per song — minimum 3 rounds, maximum 6, score must reach ≥ 80 to pass
  • Bilingual — Chinese + English albums produced in parallel
  • Parallel by song, serial by expert — N songs run simultaneously; within each song, experts work one after another

Live Demo

Album: 《赝品候鸟》 / Counterfeit Migrants — 9 tracks, ~45 min, AI-generated concept album

Version Platform Link
Chinese NetEase Cloud Music http://music.163.com/album/370761076/
English NetEase Cloud Music http://music.163.com/album/370788757/

Install this skill: openclaw skills install album-pipeline (ClawHub)


Features

🎵 End-to-End Automation 6 phases cover every step from concept to release
🧠 5-Expert Iteration Lyrics / Arrangement / Rhyme / Market / Scoring — each a dedicated sub-agent
🔄 Quality Gate Every song must score ≥ 80 before advancing; 3–6 automatic rounds
📐 Absolute File Contracts Inspired by Claude Code's design — strict input/output path and format contracts per phase; any deviation is a bug, not a feature
📝 High Skill Compliance Every phase is a self-contained SKILL.md with explicit read/write/deny scopes — designed for agents with strong instruction-following capability
🌐 Bilingual Albums Chinese + English lyrics, music, and promotional materials produced in parallel
🎨 AI Cover Generation 3 visual strategy prompts × MiniMax image-01 → album + track cover art
🎬 Promo Video Generation MiniMax video model → 6s promotional video with cover-frame reference
📦 One-Click Packaging Cover art, artist story, promo docs, videos, and platform compliance checks

Architecture

Phase 1: Album Concept         → Narrative arc + track lineup + tonal definition
           ↓
Phase 2: Song Writing           → 5 experts × 3–6 rounds per song (N songs in parallel)
           ↓
Phase 3: Lyrics Formatter       → Structure tagging (Verse/Chorus/Bridge) + char limit check
           ↓
Phase 4: Music Generator        → MiniMax CLI multi-Take parallel generation
           ↓
Phase 5: Audio Transcoder       → Listener selection + 320kbps / 44.1kHz transcoding
           ↓
Phase 6: Album Packager         → Cover concept → AI cover generation → Promo video → Packaging

Phase Details

Phase 1 — Album Concept

Input: User-provided core theme or creative direction
Output: docs/album-overview.md — narrative arc + track positioning + tonal definition

Four creative experts run in parallel, then a chief reviewer consolidates:

Expert Role
🎭 Creative Director Narrative arc and emotional arc
📊 Market Analyst Target audience and competitive landscape
🎼 Music Director Genre positioning and tonal direction
⭐ Chief Reviewer Composite score and consistency check

Phase 2 — Song Writing

Each song runs through 5 experts in serial order, repeated for 3–6 rounds:

Lyrics Expert → Arrangement Expert → Rhyme Expert → Market Expert → Scoring Expert
                                                                              ↓
                                                                        Score ≥ 80?
                                              ├─ Yes + Round ≥ 3 → ✅ Pass
                                              └─ No → Targeted revision → Next Round
Rule Value
Minimum rounds 3 (even if Round 1 scores 95)
Maximum rounds 6 (take the highest-scoring version)
Between songs Parallel (N songs run simultaneously)
Within a song Serial (5 experts operate on the same file in sequence)

Phase 3 — Lyrics Formatter

  • Extracts structural tags (Verse / Chorus / Bridge / Intro / Outro)
  • Validates character limit (≤ 3,500 characters)
  • Outputs a validation report + metadata

Phase 4 — Music Generator

Step Description
4.1 Prompt Generation 3 versions of generation prompts per song
4.2 Prompt Review Review and optimize prompt quality
4.3 CLI Execution MiniMax CLI parallel generation of multiple Takes

Phase 5 — Audio Transcoder

  • 👂 Listener Selection — user picks the final Take from multiple candidates
  • Quality Verification — post-transcode validation at 320kbps / 44.1kHz

Phase 6 — Album Packager

Sub-module Responsibility
📋 Album Overview Updater Updates the album master document
📢 Promotional Writer Album press release and marketing copy
🎤 Artist Story Writer Creative journey and backstory
🎨 Cover Designer Album cover concept and design suggestions
🖼️ Cover Prompt Generator Translates cover concepts into image-generation prompts (3 visual strategies)
🖼️ Cover Executor MiniMax image-01 → album + track cover art (PNG, 2048×2048)
🔍 Platform Checker Format compliance check for each music platform
🎬 Promo Video Executor MiniMax video model → promotional video (6s)
📦 Final Packager Archives all deliverables (docs + covers + videos + audio)

Directory Structure

album-pipeline/
├── SKILL.md                              ← Master entry point
├── FILE_CONTRACTS.md                     ← Absolute file contracts
├── album-concept/                        ← Phase 1: Concept design
├── song-writer/                          ← Phase 2: Orchestrator
├── song-expert-lyrics/                   ← Phase 2: Lyrics expert
├── song-expert-arrangement/              ← Phase 2: Arrangement expert
├── song-expert-rhyme/                    ← Phase 2: Rhyme expert
├── song-expert-market/                   ← Phase 2: Market expert
├── song-expert-scoring/                  ← Phase 2: Scoring expert
├── lyrics-formatter/                     ← Phase 3: Lyrics formatter
├── phase4-prompt-generator/              ← Phase 4.1: Prompt generation
├── phase4-prompt-reviewer/               ← Phase 4.2: Prompt review
├── phase4-music-executor/                ← Phase 4.3: MiniMax CLI execution
├── phase5-listener-selector/            ← Phase 5.1: Listener selection
├── phase5-quality-verifier/             ← Phase 5.2: Quality verification
├── phase6-album-overview-updater/       ← Phase 6.1: Album overview updater
├── phase6-promotional-writer/           ← Phase 6.2: Promotional copy
├── phase6-artist-story-writer/         ← Phase 6.3: Artist story
├── phase6-cover-designer/               ← Phase 6.4: Cover concept
├── phase6-cover-prompt-generator/      ← Phase 6.4.5: Cover prompt generation
├── phase6-cover-executor/               ← Phase 6.4.6: MiniMax image generation
├── phase6-platform-checker/             ← Phase 6.8: Platform compliance
├── phase6-promo-video-executor/         ← Phase 6.7: Promo video generation
├── phase6-packager/                     ← Phase 6.9: Final packager
├── audio-transcoder/                    ← Phase 5: Transcoder orchestrator
├── album-packager/                      ← Phase 6: Packager orchestrator
├── assets/                              ← Banner hero image
├── docs/
│   └── production-pipeline-review.md    ← Full production pipeline retrospective
└── examples/
    ├── songs/T1-出发.md                ← Example song (98-point final draft)
    ├── lyrics/cn/                       ← Example Chinese lyrics
    └── album-overview.md               ← Example album overview

File Contracts

All Phase input/output file paths, formats, and required fields are strictly defined in FILE_CONTRACTS.md.

This is the pipeline's constitution. No expert or sub-agent may deviate.

Rule Description
Read/write routes strictly per contract Each expert knows exactly what to read and what to write
File formats strictly per contract Block order, field validation, required fields — no exceptions
Any deviation = bug, must be fixed Contracting is mandatory; violations are treated as defects

See FILE_CONTRACTS.md for the full specification.


Usage

How to Trigger

User: 做一张专辑
User: album pipeline
User: AI 音乐专辑

Any of the above phrases starts the pipeline.

Example Flow

You: Make an album about the concept of "Departure" — 3 songs
         ↓
Phase 1: Concept complete — narrative arc + 3-track positioning
         ↓
Phase 2: 5 experts × 6 rounds — lyrics + arrangement + market evaluation per song
         ↓
Phase 3: Lyrics standardized — structural tags + character validation
         ↓
Phase 4: MiniMax CLI generation — multiple Takes per song in parallel
         ↓
Phase 5: Listener selects final Take → Transcoding + quality verification
         ↓
Phase 6: Packaging — cover + artist story + promotional docs + platform checks
         ↓
✅ A complete, release-ready album

Instrumental Support

Even for fully instrumental albums, all 6 phases run. Instrumental tracks are marked during Phase 1, skip the lyrics step in Phase 2 (replaced by instrumental descriptions), and the rest of the pipeline remains unchanged.


Documentation

Document Description
Production Pipeline Review Full process retrospective and lessons learned
File Contracts Input/output paths, formats, and field definitions
Example Song A 98-point final-draft song example
Lyrics Examples Standardized Chinese lyrics output examples

Roadmap

  • Phase 1–6 Core Architecture — full chain from concept to packaging
  • Multi-Expert Parallelism — 5 independent sub-agents per song
  • Bilingual Albums — Chinese + English produced in parallel
  • Quality Tuning Experiments — data collection on MiniMax generation quality vs. duration
  • More Genre Templates — Pop / Electronic / Folk / Classical presets
  • Visual Dashboard — real-time pipeline progress and score tracking

License

MIT License — See LICENSE


Acknowledgments

  • 🎵 MiniMax Music — high-quality music generation engine
  • 🛠️ OpenClaw — agent orchestration framework and sub-agent infrastructure

About

AI music album production pipeline — from concept to release, fully automated

Resources

License

Contributing

Security policy

Stars

9 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors