music-generator

name	music-generator
description	Generate AI music or lyrics from natural language with a single sentence. The system auto-detects whether to create a vocal song or pure instrumental BGM, and automatically polls the task: it returns a preview link first, then the final downloadable audio link.

Music Generator Skill (Full SOP)

Capability Overview

This skill supports the following intents:

1. Generate a full song with lyrics
2. Generate pure background music (BGM)
3. Generate lyrics only (no audio)
4. Query music generation task status

Users can describe the music they want in plain language. The system auto-determines the mode and handles parameter inference and task tracking.

---

Triggers and Natural Language Examples

The following natural language requests will trigger this skill:

• Generate a romantic love song
• Write lyrics about the night sky
• Create electronic music suitable for short‑video background
• Check my music generation progress
• I want a cheerful background music track

---

Execution (SOP Step‑by‑Step)

Preflight Check (Mandatory)

• Read MUSICFUL_API_KEY from the skill folder’s .env (resolved at runtime via the running script path): <skill_root>/.env
  • If not configured (empty/missing), immediately inform the user:
    • "MUSICFUL_API_KEY is not configured. Please visit https://www.musicful.ai/api/authentication/interface-key/ to obtain/purchase an interface key, then write the KEY into <skill_root>/.env under MUSICFUL_API_KEY."
  • Stop subsequent calls and wait for the user to complete configuration before continuing.

The execution flow is intent‑based and incorporates a two‑stage return and a "lyrics‑first" UX:

• Single command entry: /music_generator, with mode branch control: