Agent skill

Music

by guaardvark in guaardvark/guaardvark

Generate full songs with vocals or instrumentals (ACE-Step) and sound effects or ambience (Stable Audio Open) on the user's GPU through Guaardvark's Audio Foundry.

MITAuto-check passedMedia & Creative

Install Music

skills CLI
$ npx skills add guaardvark/guaardvark --skill music -a claude-code

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

GitHub CLI
$ gh skill install guaardvark/guaardvark music --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/guaardvark/guaardvark.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/music .claude/skills/music && 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/

Facts

Skill name
music
GitHub stars
257
Token cost
~710 tokens
SKILL.md length
250 words
Files
1
Skills in repo
15
Repo updated
First seen
Licence
MIT

At a glance

Generate full songs with vocals or instrumentals (ACE-Step) and sound effects or ambience (Stable Audio Open) on the user's GPU through Guaardvark's Audio Foundry.

  • The user asks for a song
  • SKILL.md covers A song, A sound effect or ambience and Then
  • Calls curl
  • Background music

What it does

Music is an agent skill from guaardvark/guaardvark. Generate full songs with vocals or instrumentals (ACE-Step) and sound effects or ambience (Stable Audio Open) on the user's GPU through Guaardvark's Audio Foundry. Use when the user asks for a song, a beat, a jingle, background music, or a sound effect, made locally with no subscription.

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

It sits in Media & Creative, covering Music and audio generation. It works with Model Context Protocol. The repository describes itself as: Self-hosted AI studio on your own GPU: chat with your files (RAG), screen and browser agents, coding swarms, LoRA training, an MCP server for Claude Code and Cursor, and local… The licence is MIT.

When your agent uses it

  • The user asks for a song
  • Background music
  • Made locally with no subscription

Example prompts

  • “s GPU through Guaardvark”
  • “/music”

What it can do on your machine

Read from SKILL.md and the folder at commit 0299024. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    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 no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Music loads about 710 tokens when it runs. Until then it costs about 74 tokens; SKILL.md has 250 words of instructions outside code blocks.

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

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

The full file from guaardvark/guaardvark at commit 0299024, republished under its MIT licence (© guaardvark). 250 words, ~710 tokens.

Download SKILL.mdSave it as .claude/skills/music/SKILL.md (or your agent's skills folder).
name
music
description
Generate full songs with vocals or instrumentals (ACE-Step) and sound effects or ambience (Stable Audio Open) on the user's GPU through Guaardvark's Audio Foundry. Use when the user asks for a song, a beat, a jingle, background music, or a sound effect, made locally with no subscription.

Music and sound effects with Guaardvark

Read setup first; needs the audio_foundry plugin. B=${GUAARDVARK_URL:-http://localhost:5000}. ACE-Step takes ~10 GB VRAM; the orchestrator evicts other models while it runs.

A song

Over MCP, call generate_music (style, optional lyrics, seconds up to 240, instrumental, seed, model); it returns a job_id for get_generation_status, which reports the file and a download link when the song is done. Without MCP, use REST:

bash
curl -s -X POST $B/api/audio-foundry/generate/music -H 'Content-Type: application/json' -d '{
  "style_prompt": "indie folk, fingerpicked acoustic guitar, warm male vocal, 96 bpm, intimate",
  "lyrics": "[verse]\nLines here\n[chorus]\nHook here",
  "negative_prompt": "distorted, muddy, synth",
  "duration_s": 90, "instrumental_only": false,
  "output_format": "wav", "seed": 1234, "async": true
}'
  • model: omit (or "ace-step") for ACE-Step v1; "ace-step-1.5" for ACE-Step 1.5 (MIT, 48 kHz, turbo model plus a planner) once it is installed in Audio Studio → Manage models. Not installed → 400 with needs_install; nothing is downloaded.
  • style_prompt uses ACE-Step's tag vocabulary: genre, instruments, mood, tempo, vocal type. Vague words ("professional", "futuristic") drift to the model's prior; be concrete. negative_prompt is accepted but neither ACE-Step model applies it (the result says negative_prompt_applied: false). POST $B/api/audio-foundry/rewrite-music-prompt turns plain English into the tag form when the user wants help.
  • lyrics with [verse] / [chorus] / [bridge] markers; omit or set instrumental_only: true.
  • duration_s up to 240. Always send "async": true for anything over a few seconds.
  • Response 202 {"job_id"} → poll GET $B/api/audio-foundry/jobs/<job_id>; done when status is done, with path, document_id, duration_s, seed. Reuse the seed to reproduce a take.

A sound effect or ambience

bash
curl -s -X POST $B/api/audio-foundry/generate/fx -H 'Content-Type: application/json' -d '{
  "prompt": "rain on a tin roof, distant thunder, no music", "duration_s": 20, "output_format": "wav", "async": true
}'

duration_s up to 47. Same job polling.

Then

  • A finished song can go straight into the music skill-video as the song.
  • Jobs: GET $B/api/audio-foundry/jobs lists, DELETE clears finished ones.
  • Attribution comes back in the job result; keep it with the file if the user publishes.

© guaardvark, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/music of guaardvark/guaardvark.

Open the folder on GitHubat commit 0299024

Compare with similar skills

Music 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 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Music this skillguaardvark/guaardvark257—~710Automated safety check: PassMIT
Text To Sfxsonilo-ai/skills1151 repos~1.6kAutomated safety check: NotesMIT
Video To Musicsonilo-ai/skills1151 repos~4kAutomated safety check: NotesMIT
Text To Musicsonilo-ai/skills115—~2.7kAutomated safety check: NotesMIT
Video Analysissonilo-ai/skills115—~3.5kAutomated safety check: NotesMIT
Video To Sfxsonilo-ai/skills115—~2.3kAutomated safety check: NotesMIT

Similar skills

  • Text To Sfx

    sonilo-ai/skills

    Generate a sound effect from a text description using Sonilo — a UI chime, a whoosh, an impact, ambience, a stylized cue — when there is no video to match.

    115 GitHub starsUsed in 1 repo~1.6k tokens
    Media & CreativeAuto-check: notes
  • Video To Music

    sonilo-ai/skills

    Score a video with original music using Sonilo — the model watches the cut and matches pacing, motion, and emotion, returning either the audio or a new video with the score muxed in.

    115 GitHub starsUsed in 1 repo~4k tokens
    Media & CreativeAuto-check: notes
  • Text To Music

    sonilo-ai/skills

    Generate music from a text prompt using Sonilo — instrumental tracks, background beds, jingles, loops — when there is no video to score.

    115 GitHub stars~2.7k tokensUpdated yesterday
    Media & CreativeAuto-check: notes
  • Video Analysis

    sonilo-ai/skills

    Analyze a video with Sonilo and get back a creative brief for its sound, derived from the footage itself — by default both a music-direction brief (a time-aligned section plan plus one or more…

    115 GitHub stars~3.5k tokensUpdated yesterday
    Media & CreativeAuto-check: notes
  • Video To Sfx

    sonilo-ai/skills

    Generate sound effects matched to a video using Sonilo — footsteps, impacts, ambience, foley — optionally scripted to specific timed segments, returning either the audio or a new video with the SFX…

    115 GitHub stars~2.3k tokensUpdated yesterday
    Media & CreativeAuto-check: notes
  • Video To Sound

    sonilo-ai/skills

    Generate music AND sound effects for a video in a single balanced, single-charge call using Sonilo.

    115 GitHub stars~2.6k tokensUpdated yesterday
    Media & CreativeAuto-check: notes

More from guaardvark/guaardvark

All 15 skills in this repo
  • Cast

    guaardvark/guaardvark

    Build consistent characters, environments and props in Guaardvark's Cast Library and train LoRAs for them locally (reference photos → vision bible → sample plan → approved samples → training).

    257 GitHub stars~673 tokensUpdated today
    Auto-check passed
  • Image

    guaardvark/guaardvark

    Generate or edit images on the user's own GPU through Guaardvark: single images, instruction edits, background cut-outs, inpaint and outpaint, consistent characters from the Cast Library, and batch…

    257 GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Ops

    guaardvark/guaardvark

    Operate a running Guaardvark: GPU and VRAM state, plugin start/stop, logs, Celery tasks, the Interconnector sync to other machines, overnight RAG autoresearch, and infographics.

    257 GitHub stars~779 tokensUpdated today
    Auto-check passed
  • Setup

    guaardvark/guaardvark

    Connect this agent to a running Guaardvark (self-hosted AI studio) and check what it can do right now.

    257 GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Swarm

    guaardvark/guaardvark

    Launch and watch Guaardvark's Swarm Orchestrator: parallel coding agents, each in its own git worktree, working a markdown plan and merging back deterministically.

    257 GitHub stars~746 tokensUpdated today
    Auto-check passed
  • Upscale

    guaardvark/guaardvark

    Upscale images and video 2x to 4K/8K on the user's GPU through Guaardvark (Real-ESRGAN, HAT-L, SwinIR, two-pass).

    257 GitHub stars~493 tokensUpdated today
    Auto-check passed

Questions about Music

What does Music do?

Generate full songs with vocals or instrumentals (ACE-Step) and sound effects or ambience (Stable Audio Open) on the user's GPU through Guaardvark's Audio Foundry. Music is an agent skill from guaardvark/guaardvark. Generate full songs with vocals or instrumentals (ACE-Step) and sound effects or ambience (Stable Audio Open) on the user's GPU through Guaardvark's Audio Foundry.

When should I use Music?

Music fits situations like: the user asks for a song; background music; made locally with no subscription.

How do I install Music in Claude Code?

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

How do I install Music in Codex?

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

Can I use Music 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 guaardvark/guaardvark --skill music -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, .gemini/skills/music, .github/skills/music and .opencode/skills/music in your project.

What does Music need to run?

Going by SKILL.md and its folder, Music needs the command-line tools its instructions call (curl).

Does Music 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 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 use?

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

About 710 tokens (SKILL.md is roughly 2.8k 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?

Skills that share tags, products or a category with Music: Text To Sfx (sonilo-ai/skills, 115 stars), Video To Music (sonilo-ai/skills, 115 stars), Text To Music (sonilo-ai/skills, 115 stars) and Video Analysis (sonilo-ai/skills, 115 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Music?

guaardvark (a GitHub user) maintains it in guaardvark/guaardvark, which has 257 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on October 9, 2026.

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