Agent skill

Music Generate

Generate a new song from a creative brief (genre, mood, language, BPM, theme) via the cogmusic MCP createproduction tool

MITAuto-check passed

Install Music Generate

skills CLI

$ npx skills add ruvnet/ruflo --skill music-generate -a claude-code

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

GitHub CLI

$ gh skill install ruvnet/ruflo music-generate --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/ruvnet/ruflo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/ruflo-music/skills/music-generate .claude/skills/music-generate && 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/

Paste into Claude Code

Install the "music-generate" agent skill from https://github.com/ruvnet/ruflo/tree/main/plugins/ruflo-music/skills/music-generate into .claude/skills/music-generate/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "music-generate", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/ruvnet/ruflo/tree/main/plugins/ruflo-music/skills/music-generate

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add ruvnet/ruflo --skill music-generate -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install ruvnet/ruflo music-generate --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ruvnet/ruflo.git skills-src && mkdir -p .agents/skills && cp -r skills-src/plugins/ruflo-music/skills/music-generate .agents/skills/music-generate && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "music-generate" agent skill from https://github.com/ruvnet/ruflo/tree/main/plugins/ruflo-music/skills/music-generate into .agents/skills/music-generate/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "music-generate", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add ruvnet/ruflo --skill music-generate -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install ruvnet/ruflo music-generate --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ruvnet/ruflo.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/plugins/ruflo-music/skills/music-generate .cursor/skills/music-generate && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "music-generate" agent skill from https://github.com/ruvnet/ruflo/tree/main/plugins/ruflo-music/skills/music-generate into .cursor/skills/music-generate/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "music-generate", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/ruvnet/ruflo.git --path plugins/ruflo-music/skills/music-generate

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add ruvnet/ruflo --skill music-generate -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install ruvnet/ruflo music-generate --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ruvnet/ruflo.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/plugins/ruflo-music/skills/music-generate .gemini/skills/music-generate && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "music-generate" agent skill from https://github.com/ruvnet/ruflo/tree/main/plugins/ruflo-music/skills/music-generate into .gemini/skills/music-generate/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "music-generate", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install ruvnet/ruflo music-generate

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add ruvnet/ruflo --skill music-generate -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/ruvnet/ruflo.git skills-src && mkdir -p .github/skills && cp -r skills-src/plugins/ruflo-music/skills/music-generate .github/skills/music-generate && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "music-generate" agent skill from https://github.com/ruvnet/ruflo/tree/main/plugins/ruflo-music/skills/music-generate into .github/skills/music-generate/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "music-generate", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add ruvnet/ruflo --skill music-generate -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install ruvnet/ruflo music-generate --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ruvnet/ruflo.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/plugins/ruflo-music/skills/music-generate .opencode/skills/music-generate && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "music-generate" agent skill from https://github.com/ruvnet/ruflo/tree/main/plugins/ruflo-music/skills/music-generate into .opencode/skills/music-generate/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "music-generate", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: music-generate
GitHub stars: 74k
Token cost: ~991 tokens
SKILL.md length: 402 words
Files: 1
Skills in repo: 265
Repo updated: Oct 10, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Generate a new song from a creative brief (genre, mood, language, BPM, theme) via the cogmusic MCP createproduction tool

Works in 6 steps: Compose the two required inputs from the… → Pick audio_duration (seconds, default 30… → Call the tool — it blocks for real… → …
SKILL.md covers When to use, Steps and Known reliability notes
Calls curl; needs COGMUSIC_TOKEN

What it does

Music Generate is an agent skill from ruvnet/ruflo. Generate a new song from a creative brief (genre, mood, language, BPM, theme) via the cogmusic MCP createproduction tool

Its SKILL.md is about 990 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with Model Context Protocol. The repository describes itself as: 🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory…. The licence is MIT.

Example prompts

“/music-generate”

Requirements

A credential in COGMUSIC_TOKEN
Pre-approved tools (allowed-tools): mcp__cogmusic__create_production, mcp__plugin_ruflo-core_ruflo__memory_store, mcp__plugin_ruflo-core_ruflo__memory_search

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

Compose the two required inputs from the brief (delegate the actual writing to the music-composer agent for anything beyond a trivial…
Pick audio_duration (seconds, default 30 if unspecified). 90–150s covers a real verse/chorus/bridge structure; don't go far past 150s…
Call the tool — it blocks for real minutes, not seconds
On success, the result includes id, title, audio_duration, created_at_unix, and an audio_url. Fetch the audio itself (or hand the URL to…
Cache the result for later recall (namespace music-productions, see the plugin README's Namespace coordination section)
Report back: title, duration, the audio_url, and a one-line summary of the style. Don't claim the audio "sounds like X" — you cannot hear…

What it can do on your machine

Read from SKILL.md and the folder at commit 6c04654. 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:
- mcp__cogmusic__create_production
- mcp__plugin_ruflo-core_ruflo__memory_store
- mcp__plugin_ruflo-core_ruflo__memory_search
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- curl
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use curl, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- COGMUSIC_TOKEN
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Music Generate loads about 991 tokens when it runs. Until then it costs about 34 tokens; SKILL.md has 402 words of instructions outside code blocks.

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

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

Download SKILL.mdSave it as .claude/skills/music-generate/SKILL.md (or your agent's skills folder).

name: music-generate
description: Generate a new song from a creative brief (genre, mood, language, BPM, theme) via the cogmusic MCP create_production tool
allowed-tools: mcp__cogmusic__create_production, mcp__plugin_ruflo-core_ruflo__memory_store, mcp__plugin_ruflo-core_ruflo__memory_search
argument-hint: <brief describing genre/mood/language/theme>

Music Generate

Turns a creative brief into a real, playable track through the user's own Cognitum Music account.

When to use

The user asks to create/generate/produce a song, remix, or track. If mcp__cogmusic__create_production isn't loaded, run music-connect first.

Steps

Compose the two required inputs from the brief (delegate the actual writing to the music-composer agent for anything beyond a trivial brief — lyrics quality matters more than most callers expect):
- lyrics — structured with [intro]/[verse]/[chorus]/[bridge]/[outro] tags, one section per line group. Match the language the user asked for; don't default to English if they named another language.
- prompt — genre, BPM, instrumentation, and mood in one dense sentence. Be specific (e.g. "Afrobeat, 116 BPM, talking drum, shekere, horn section" beats "upbeat African music").
Pick audio_duration (seconds, default 30 if unspecified). 90–150s covers a real verse/chorus/bridge structure; don't go far past 150s without the user asking — generation time and cost both scale with duration, and the model's documented ceiling is 300s.
Call the tool — it blocks for real minutes, not seconds:
```
mcp__cogmusic__create_production({
  title: "...",
  lyrics: "...",
  prompt: "...",
  audio_duration: 120,
})
```
Do not poll or retry mid-call — the underlying bridge (cogmusic@0.1.1+) already carries a long internal timeout. If it returns {"content":[{"text":"generation failed", ...}],"isError":true}, this is very likely a transient GPU-inference-service issue (see ADR-0001's Known reliability notes), not a bad prompt — retry once before concluding something is actually wrong with the request itself.
On success, the result includes id, title, audio_duration, created_at_unix, and an audio_url. Fetch the audio itself (or hand the URL to the user) with:
bash
```
curl -H "authorization: Bearer $COGMUSIC_TOKEN" "$AUDIO_URL" -o track.wav
```
Audio is never returned inline over MCP by design (see ADR-0001) — always a separate authenticated GET.

Cache the result for later recall (namespace music-productions, see the plugin README's Namespace coordination section):

mcp__plugin_ruflo-core_ruflo__memory_store({
  key: "production-<id>",
  value: JSON.stringify({ id, title, audio_url, prompt, lyrics, audio_duration, created_at_unix }),
  namespace: "music-productions",
})

Also store the brief that produced it (namespace music-briefs) so a later "make another one like that" can retrieve the exact prompt/lyrics shape that worked:

mcp__plugin_ruflo-core_ruflo__memory_store({
  key: "brief-<id>",
  value: JSON.stringify({ id, brief: "<the user's original request>", prompt, lyrics }),
  namespace: "music-briefs",
})

Report back: title, duration, the audio_url, and a one-line summary of the style. Don't claim the audio "sounds like X" — you cannot hear it; describe what was requested, not the result.

Show full SKILL.md (67 more words)Show less

Known reliability notes

The GPU inference service behind Cognitum Music has a real, documented history of intermittent generation failures (cold-start weight-loading races — see the upstream repo's ADR-0022/0023). A single retry resolves most transient failures. If two consecutive attempts with the same prompt/lyrics both fail, say so plainly rather than silently retrying a third time — that's a signal something's actually wrong on the service side, not bad luck.

Files

Just SKILL.md in plugins/ruflo-music/skills/music-generate of ruvnet/ruflo.

Open the folder on GitHubat commit 6c04654

Compare with similar skills

Music Generate 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.

Music Generate compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Music Generate this skillruvnet/ruflo	74k	—	~991	Automated safety check: Pass	MIT	today
MCP Server Builderanthropics/skills	180k	63 repos	~2.3k	Automated safety check: Pass	Apache-2.0	today
MCP Server BuildershareAI-lab/learn-claude-code	78k	4 repos	~1.2k	Automated safety check: Pass	MIT	12 days ago
MCP Integration for Pluginsanthropics/claude-plugins-official	38k	11 repos	~3.1k	Automated safety check: Pass	Apache-2.0	today
Figma use_figma Plugin API Ruleswarpdotdev/warp	65k	4 repos	~4.4k	Automated safety check: Pass	AGPL-3.0	today
Stitch to Remotion Walkthrough Videosgoogle-labs-code/stitch-skills	8.5k	6 repos	~3.2k	Automated safety check: Notes	Apache-2.0	1 mo ago

Similar skills

MCP Server Builder
anthropics/skills
Official
Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.
180k GitHub starsUsed in 63 repos~2.3k tokens
Agent WorkflowsAuto-check passed
MCP Server Builder
shareAI-lab/learn-claude-code
Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.
78k GitHub starsUsed in 4 repos~1.2k tokens
Agent WorkflowsAuto-check passed
MCP Integration for Plugins
anthropics/claude-plugins-official
Official
Explains how to bundle Model Context Protocol servers in a Claude Code plugin, covering config files, stdio, SSE, HTTP and WebSocket server types, and authentication.
38k GitHub starsUsed in 11 repos~3.1k tokens
Agent WorkflowsAuto-check passed
Figma use_figma Plugin API Rules
warpdotdev/warp
Required groundwork before any use_figma call: the rules and reference files for running JavaScript in a Figma file through the Plugin API without common failures.
65k GitHub starsUsed in 4 repos~4.4k tokens
Frontend & DesignAuto-check passed
Stitch to Remotion Walkthrough Videos
google-labs-code/stitch-skills
Official
Builds walkthrough videos from Stitch design projects using Remotion, with transitions, zoom effects and text overlays on each screen.
8.5k GitHub starsUsed in 6 repos~3.2k tokens
Media & CreativeAuto-check: notes
MCP Development
coollabsio/coolify
A skill your agent uses for Laravel MCP development. An agent skill from coollabsio/coolify.
63k GitHub starsUsed in 1 repo~949 tokens
Frontend & DesignAuto-check passed

Questions about Music Generate

What does Music Generate do?

Generate a new song from a creative brief (genre, mood, language, BPM, theme) via the cogmusic MCP createproduction tool. Music Generate is an agent skill from ruvnet/ruflo.

How do I install Music Generate in Claude Code?

Run `npx skills add ruvnet/ruflo --skill music-generate -a claude-code`. Or copy the skill folder (plugins/ruflo-music/skills/music-generate in ruvnet/ruflo) into .claude/skills/music-generate in your project. Claude Code loads it when a task matches its description.

How do I install Music Generate in Codex?

Run `npx skills add ruvnet/ruflo --skill music-generate -a codex`. Or copy the skill folder (plugins/ruflo-music/skills/music-generate in ruvnet/ruflo) into .agents/skills/music-generate in your project. Codex loads it when a task matches its description.

Can I use Music Generate 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 ruvnet/ruflo --skill music-generate -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/music-generate, .gemini/skills/music-generate, .github/skills/music-generate and .opencode/skills/music-generate in your project.

What does Music Generate need to run?

Going by SKILL.md and its folder, Music Generate needs the command-line tools its instructions call (curl) and credentials named COGMUSIC_TOKEN. Our summary lists: A credential in COGMUSIC_TOKEN. Its frontmatter pre-approves these tools: mcp__cogmusic__create_production, mcp__plugin_ruflo-core_ruflo__memory_store, mcp__plugin_ruflo-core_ruflo__memory_search.

Does Music Generate access the network?

SKILL.md contains no URLs. Its commands use curl, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Music Generate 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 Music Generate use?

Music Generate is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Music Generate use?

About 991 tokens (SKILL.md is roughly 4k 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 Music Generate?

Skills that share tags, products or a category with Music Generate: MCP Server Builder (anthropics/skills, 180k stars), MCP Server Builder (shareAI-lab/learn-claude-code, 78k stars), MCP Integration for Plugins (anthropics/claude-plugins-official, 38k stars) and Figma use_figma Plugin API Rules (warpdotdev/warp, 65k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Music Generate?

ruvnet (a GitHub user) maintains it in ruvnet/ruflo, which has 74,222 GitHub stars. The repository holds 265 skills in this directory. The repository was last updated on October 10, 2026.

Source: ruvnet/ruflo on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Music Generate

Install Music Generate

Facts

At a glance

What it does

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Music Generate

When to use

Steps

Known reliability notes

Files

Compare with similar skills

Similar skills

MCP Server Builder

MCP Server Builder

MCP Integration for Plugins

Figma use_figma Plugin API Rules

Stitch to Remotion Walkthrough Videos

MCP Development

More from ruvnet/ruflo

AgentDB Pattern Memory

Security Audit Scanner

SPARC Development Methodology

Swarm Orchestration

Ruflo Multi-Agent Orchestration

Agent Coordination

Questions about Music Generate

Install Music Generate

Facts

At a glance

What it does

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Music Generate

When to use

Steps

Known reliability notes

Files

Compare with similar skills

Similar skills

More from ruvnet/ruflo

Related

Questions about Music Generate