Agent skill

ACE-Step Music Generation

by digitalsamba in digitalsamba/claude-code-video-toolkit

Generates background music, vocal tracks, covers and stems with ACE-Step 1.5 through a bundled music_gen.py tool, using cloud or self-hosted providers.

MITAuto-check: notesMedia & Creative

Install ACE-Step Music Generation

skills CLI
$ npx skills add digitalsamba/claude-code-video-toolkit --skill acestep -a claude-code

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

GitHub CLI
$ gh skill install digitalsamba/claude-code-video-toolkit acestep --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/digitalsamba/claude-code-video-toolkit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/acestep .claude/skills/acestep && 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
acestep
GitHub stars
2.2k
Token cost
~3.3k tokens
SKILL.md length
1,052 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Generates background music, vocal tracks, covers and stems with ACE-Step 1.5 through a bundled music_gen.py tool, using cloud or self-hosted providers.

  • Works in 4 steps: Instrumental background track (simplest) → Song with vocals and lyrics → Repaint a weak section → …
  • Creating background music for a video from a short prompt
  • SKILL.md covers Setup, Quick Reference, Fixing "Samey" Output and Creating a Song (Step by Step), plus 6 more sections
  • Calls uv; reaches acemusic.ai; needs ACEMUSIC_API_KEY

What it does

This skill documents tools/music_gen.py, an open-source music generation tool built on ACE-Step 1.5, aimed at video production. It covers background music and soundtracks, songs with vocals and lyrics using structure tags, covers and style transfer, stem extraction, repainting a weak section of a track, and continuing or extending a track. Typical commands set a prompt, duration, BPM, key and output file.

Three providers are supported. The default, acemusic, is the official ACE-Step cloud API, needs a free API key and no GPU. Modal and RunPod run a self-hosted 2B Turbo model and need endpoint settings in the environment. A troubleshooting list for repetitive output suggests keeping thinking mode on, generating several variations, using stochastic inference, varying BPM, key and seed across scenes and writing sparser prompts.

When your agent uses it

  • Creating background music for a video from a short prompt
  • Writing a song with vocals and lyrics
  • Repainting a weak chorus or extending an existing track
  • Extracting stems from a song

Example prompts

  • “Generate 60 seconds of upbeat tech corporate background music as bg.mp3.”
  • “Write an indie rock song with lyrics about a road trip and save it as track.mp3.”
  • “Repaint the chorus of my_song.mp3 between 20 and 35 seconds with bigger drums.”
  • “Extract the stems from demo.mp3.”

Requirements

  • An ACEMUSIC_API_KEY for the default cloud provider
  • uv, to run tools/music_gen.py
  • Modal or RunPod endpoint settings for self-hosted generation

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Instrumental background track (simplest)
  2. Song with vocals and lyrics
  3. Repaint a weak section
  4. Continue/extend a track

What it can do on your machine

Read from SKILL.md and the folder at commit 2c99460. 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:

    • uv

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • acemusic.ai

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • ACEMUSIC_API_KEY

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

Context cost

ACE-Step Music Generation loads about 3.3k tokens when it runs. Until then it costs about 101 tokens; SKILL.md has 1,052 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:19
    echo "ACEMUSIC_API_KEY=your_key" >> .env

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 digitalsamba/claude-code-video-toolkit at commit 2c99460, republished under its MIT licence (© digitalsamba). 1,052 words, ~3,321 tokens.

Download SKILL.mdSave it as .claude/skills/acestep/SKILL.md (or your agent's skills folder).
name
acestep
description
AI music generation with ACE-Step 1.5 — background music, vocal tracks, covers, stem extraction, audio repainting, and continuation for video production. Use when generating music, soundtracks, jingles, or working with audio stems. Triggers include background music, soundtrack, jingle, music generation, stem extraction, cover, style transfer, repaint, continuation, or musical composition tasks.

ACE-Step 1.5 Music Generation

Open-source music generation via tools/music_gen.py.

Cloud providers:

  • acemusic (default) — Official ACE-Step cloud API with XL Turbo (4B) model + 5Hz LM thinking mode. Free API key from acemusic.ai/api-key. No GPU required.
  • modal — Self-hosted ACE-Step 2B Turbo on Modal. Requires MODAL_MUSIC_GEN_ENDPOINT_URL.
  • runpod — Self-hosted ACE-Step 2B Turbo on RunPod. Requires RUNPOD_ACESTEP_ENDPOINT_ID.

Setup

bash
# acemusic (recommended — free, best quality, no GPU)
echo "ACEMUSIC_API_KEY=your_key" >> .env
# Get key at https://acemusic.ai/api-key

# Self-hosted (optional fallback)
uv run tools/music_gen.py --setup             # RunPod
uv run modal deploy docker/modal-music-gen/app.py    # Modal

Quick Reference

bash
# Basic generation (uses acemusic XL Turbo by default)
uv run tools/music_gen.py --prompt "Upbeat tech corporate" --duration 60 --output bg.mp3

# Generate 4 variations, pick the best
uv run tools/music_gen.py --prompt "Calm ambient piano" --duration 30 --variations 4 --output ambient.mp3

# Fast mode (disable thinking)
uv run tools/music_gen.py --no-thinking --prompt "Quick draft" --duration 30 --output draft.mp3

# With musical control
uv run tools/music_gen.py --prompt "Calm ambient piano" --duration 30 --bpm 72 --key "D Major" --output ambient.mp3

# Scene presets (video production)
uv run tools/music_gen.py --preset corporate-bg --duration 60 --output bg.mp3
uv run tools/music_gen.py --preset tension --duration 20 --output problem.mp3
uv run tools/music_gen.py --preset cta --brand digital-samba --duration 15 --output cta.mp3

# Vocals with lyrics
uv run tools/music_gen.py --prompt "Indie pop jingle" --lyrics "[verse]\nBuild it better\nShip it faster" --duration 30 --output jingle.mp3

# Cover / style transfer
uv run tools/music_gen.py --cover --reference theme.mp3 --prompt "Jazz piano version" --duration 60 --output jazz_cover.mp3

# Repaint a weak section
uv run tools/music_gen.py --repaint --input track.mp3 --repaint-start 15 --repaint-end 25 --prompt "Guitar solo" --output fixed.mp3

# Continue from existing audio
uv run tools/music_gen.py --continuation --input track.mp3 --prompt "Continue with jazz piano" --output extended.mp3

# Stem extraction
uv run tools/music_gen.py --extract vocals --input mixed.mp3 --output vocals.mp3

# Fall back to self-hosted
uv run tools/music_gen.py --cloud modal --prompt "Background music" --duration 60 --output bg.mp3

Fixing "Samey" Output

If generated music sounds repetitive or lacks variety, try these in order:

  1. Use acemusic cloud (default) — the XL Turbo 4B model is significantly more capable than the 2B model on Modal/RunPod
  2. Keep thinking mode on (default for acemusic) — the 5Hz LM enriches sparse prompts into detailed musical descriptions
  3. Generate variations — --variations 4 generates 4 takes, pick the best
  4. Use stochastic inference — --infer-method sde adds randomness (same seed gives different results)
  5. Vary BPM and key across scenes — don't use the same preset for every scene
  6. Write sparser prompts — "Upbeat indie rock" gives the model more creative freedom than a hyper-detailed description
  7. Vary seeds — omit --seed to let each generation be unique

Creating a Song (Step by Step)

1. Instrumental background track (simplest)
bash
uv run tools/music_gen.py --prompt "Upbeat indie rock, driving drums, jangly guitar" --duration 60 --bpm 120 --key "G Major" --output track.mp3
2. Song with vocals and lyrics

Write lyrics in a temp file or pass inline. Use structure tags to control song sections.

bash
# Write lyrics to a file first (recommended for longer songs)
cat > /tmp/lyrics.txt << 'LYRICS'
[Verse 1]
Walking through the morning light
Coffee in my hand feels right
Another day to build and dream
Nothing's ever what it seems

[Chorus - anthemic]
WE KEEP MOVING FORWARD
Through the noise and doubt
We keep moving forward
That's what it's about

[Verse 2]
Screens are glowing late at night
Shipping code until it's right
The deadline's close but so are we
Almost there, just wait and see

[Chorus - bigger]
WE KEEP MOVING FORWARD
Through the noise and doubt
We keep moving forward
That's what it's about

[Outro - fade]
(Moving forward...)
LYRICS

# Generate the song
uv run tools/music_gen.py \
  --prompt "Upbeat indie rock anthem, male vocal, driving drums, electric guitar, studio polish" \
  --lyrics "$(cat /tmp/lyrics.txt)" \
  --duration 60 \
  --bpm 128 \
  --key "G Major" \
  --output my_song.mp3
3. Repaint a weak section

If the chorus sounds weak, regenerate just that section:

bash
uv run tools/music_gen.py --repaint --input my_song.mp3 --repaint-start 20 --repaint-end 35 --prompt "Powerful anthemic chorus, big drums" --output fixed.mp3
4. Continue/extend a track
bash
uv run tools/music_gen.py --continuation --input my_song.mp3 --prompt "Continue with gentle acoustic outro" --output extended.mp3
Key tips for good results
  • Caption = overall style (genre, instruments, mood, production quality)
  • Lyrics = temporal structure (verse/chorus flow, vocal delivery)
  • UPPERCASE in lyrics = high vocal intensity
  • Parentheses = background vocals: "We rise (together)"
  • Keep 6-10 syllables per line for natural rhythm
  • Don't describe the melody in the caption — describe the sound and feeling
  • Use --seed to lock randomness when iterating on prompt/lyrics
Controlling vocal gender

The model doesn't reliably follow "female vocal" or "male vocal" on its own. Use both of these together:

  1. In the prompt: Be explicit — "solo female singer, alto voice" or "female vocalist only, breathy intimate voice". Adding an artist reference helps (e.g., "Brandi Carlile style").
  2. In the lyrics: Add [female vocal] tags before each section:
[female vocal]
[Verse 1]
Walking through the morning light...

[female vocal]
[Chorus - anthemic]
WE KEEP MOVING FORWARD...

Just saying "female vocal" in the prompt alone is often ignored. The combination of prompt + lyrics tags is what works.

Duets and vocal trading

For duets with male/female vocals trading verses, use both the prompt and per-section lyrics tags:

  • Prompt: "duet, male and female vocals trading verses, warm harmonies on chorus"
  • Lyrics: Tag each section with who sings it:
[Verse 1 - male vocal, storytelling]
First verse lyrics here...

[Chorus - male and female duet, harmonies]
Chorus lyrics here...

[Verse 2 - female vocal, wry]
Second verse lyrics here...

[Bridge - male vocal, spoken]
Spoken bridge...

[Bridge - female vocal, sung]
Sung response...

This reliably produces vocal trading between sections and harmonies on shared parts.

Scene Presets

PresetBPMKeyUse Case
corporate-bg110C MajorProfessional background, presentations
upbeat-tech128G MajorProduct launches, tech demos
ambient72D MajorOverview slides, reflective content
dramatic90D MinorReveals, announcements
tension85A MinorProblem statements, challenges
hopeful120C MajorSolution reveals, resolutions
cta135E MajorCall to action, closing energy
lofi85F MajorScreen recordings, coding demos

Task Types

text2music (default)

Generate music from text prompt + optional lyrics.

cover

Style transfer from reference audio. Control blend with --cover-strength (0.0-1.0):

  • 0.2 — Loose style inspiration (more creative freedom)
  • 0.5 — Balanced style transfer
  • 0.7 — Close to original structure (default)
  • 1.0 — Maximum fidelity to source
extract

Stem separation — isolate individual tracks from mixed audio. Tracks: vocals, drums, bass, guitar, piano, keyboard, strings, brass, woodwinds, other

repainting (acemusic only)

Regenerate a specific time segment within existing audio while preserving the rest.

bash
uv run tools/music_gen.py --repaint --input track.mp3 --repaint-start 15 --repaint-end 25 --prompt "Guitar solo" --output fixed.mp3
continuation (acemusic only)

Extend existing audio by continuing from where it ends.

bash
uv run tools/music_gen.py --continuation --input track.mp3 --prompt "Continue with jazz piano" --output extended.mp3

Prompt Engineering

Caption Writing — Layer Dimensions

Write captions by layering multiple descriptive dimensions rather than single-word descriptions.

Dimensions to include:

  • Genre/Style: pop, rock, jazz, electronic, lo-fi, synthwave, orchestral
  • Emotion/Mood: melancholic, euphoric, dreamy, nostalgic, intimate, tense
  • Instruments: acoustic guitar, synth pads, 808 drums, strings, brass, piano
  • Timbre: warm, crisp, airy, punchy, lush, polished, raw
  • Era: "80s synth-pop", "modern indie", "classical romantic"
  • Production: lo-fi, studio-polished, live recording, cinematic
  • Vocal: breathy, powerful, falsetto, raspy, spoken word (or "instrumental")

Good: "Slow melancholic piano ballad with intimate female vocal, warm strings building to powerful chorus, studio-polished production" Bad: "Sad song"

Show full SKILL.md (382 more words)Show less
Key Principles
  1. Specificity over vagueness — describe instruments, mood, production style
  2. Avoid contradictions — don't request "classical strings" and "hardcore metal" simultaneously
  3. Repetition reinforces priority — repeat important elements for emphasis
  4. Sparse captions = more creative freedom — detailed captions constrain the model
  5. Use metadata params for BPM/key — don't write "120 BPM" in the caption, use --bpm 120
Lyrics Formatting

Structure tags (use in lyrics, not caption):

[Intro]
[Verse]
[Chorus]
[Bridge]
[Outro]
[Instrumental]
[Guitar Solo]
[Build]
[Drop]
[Breakdown]

Vocal control (prefix lines or sections):

[raspy vocal]
[whispered]
[falsetto]
[powerful belting]
[harmonies]
[ad-lib]

Energy indicators:

  • UPPERCASE = high intensity ("WE RISE ABOVE")
  • Parentheses = background vocals ("We rise (together)")
  • Keep 6-10 syllables per line within sections for natural rhythm

Video Production Integration

Music for Scene Types
ScenePresetDurationNotes
Titledramatic or ambient3-5sShort, mood-setting
Problemtension10-15sDark, unsettling
Solutionhopeful10-15sRelief, optimism
Demolofi or corporate-bg30-120sNon-distracting, matches demo length
Statsupbeat-tech8-12sBuilding credibility
CTActa5-10sMaximum energy, punchy
Creditsambient5-10sGentle fade-out
Timing Workflow
  1. Plan scene durations first (from voiceover script)
  2. Generate music to match: --duration <scene_seconds>
  3. Music duration is precise (within 0.1s of requested)
  4. For background music spanning multiple scenes: generate one long track
Combining with Voiceover

Background music should be mixed at 10-20% volume in Remotion:

tsx
<Audio src={staticFile('voiceover.mp3')} volume={1} />
<Audio src={staticFile('bg-music.mp3')} volume={0.15} />

For music under narration: use instrumental presets (corporate-bg, ambient, lofi). For music-forward scenes (title, CTA): can use higher volume or vocal tracks.

Brand Consistency

Use --brand <name> to load hints from brands/<name>/brand.json. Use --cover --reference brand_theme.mp3 to create variations of a brand's sonic identity. For consistent sound across a project: fix the seed (--seed 42) and vary only duration/prompt.

Advanced Parameters

FlagDefaultDescription
--thinkingon (acemusic)5Hz LM enriches prompts and generates audio codes
--no-thinking-Faster generation, skip LM reasoning
--variations N1Generate N variations (1-8, acemusic only)
--guidance-scale7.0Prompt adherence (1.0-15.0)
--infer-methododeode (deterministic) or sde (stochastic, more variety)
--seedrandomLock randomness for reproducibility

Technical Details

  • acemusic cloud: XL Turbo 4B DiT + 4B LM, best quality, ~5-15s per generation
  • Modal/RunPod: Standard Turbo 2B DiT, no LM, ~2-3s per generation
  • Output: 48kHz MP3/WAV/FLAC
  • Duration range: 10-600 seconds
  • BPM range: 30-300
When NOT to use ACE-Step
  • Voice cloning — use Qwen3-TTS or ElevenLabs instead
  • Sound effects — use ElevenLabs SFX (tools/sfx.py)
  • Speech/narration — use voiceover tools, not music gen
  • Stem extraction from video — extract audio first with FFmpeg, then use --extract

© digitalsamba, 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 .claude/skills/acestep of digitalsamba/claude-code-video-toolkit.

Open the folder on GitHubat commit 2c99460

Compare with similar skills

ACE-Step Music Generation 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.

ACE-Step Music Generation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
ACE-Step Music Generation this skilldigitalsamba/claude-code-video-toolkit2.2k—~3.3kAutomated safety check: NotesMIT
VRGDG H3 Short Film Pipelinevrgamegirl19/comfyui-vrgamedevgirl763—~4.2kAutomated safety check: PassCustom licence
Music to Videoheygen-com/hyperframes59k3 repos~4.7kAutomated safety check: NotesApache-2.0
Qiaomu Cutjoeseesun/qiaomu-cut-skill372—~6.8kAutomated safety check: NotesMIT
HyperFrames Audioheygen-com/hyperframes59k1 repos~6.4kAutomated safety check: PassApache-2.0
Paper Collage Explainer Generatortl2012tl/comfyUI-llama-TE2414 repos~5.2kAutomated safety check: PassNone

Similar skills

  • VRGDG H3 Short Film Pipeline

    vrgamegirl19/comfyui-vrgamedevgirl

    Builds an AI short film in a local ComfyUI with the VRGDG Video Builder, MiniMax H3 scenes, reference images, a music score, QA and a final edit.

    763 GitHub stars~4.2k tokensUpdated today
    Media & CreativeAuto-check passed
  • Music to Video

    heygen-com/hyperframes

    Turns a music track into a beat-synced HyperFrames video such as a lyric video, slideshow or kinetic promo, with any supplied images or clips cut onto the beat grid.

    59k GitHub starsUsed in 3 repos~4.7k tokens
    Media & CreativeAuto-check: notes
  • Qiaomu Cut

    joeseesun/qiaomu-cut-skill

    把一句话需求转成可复现、可验收视频工程的乔木智能剪辑导演。Use when the user asks to create, plan, edit, remix, explain, narrate, subtitle, animate, composite, or render a video—including one-line requests such as “制作一个科普视频:介绍…

    372 GitHub stars~6.8k tokensUpdated 11 days ago
    Media & CreativeAuto-check: notes
  • HyperFrames Audio

    heygen-com/hyperframes

    Mixes audio already placed in a HyperFrames composition: fades, gain, ducking under a voiceover, effect chains, automation and shared submix buses.

    59k GitHub starsUsed in 1 repo~6.4k tokens
    Media & CreativeAuto-check passed
  • Paper Collage Explainer Generator

    tl2012tl/comfyUI-llama-TE

    For creators, educators, and social-video editors who need a tactile paper-collage language for narration, knowledge points, opinions, or abstract topics.

    241 GitHub starsUsed in 4 repos~5.2k tokens
    Media & CreativeAuto-check passed
  • Showtime

    FavioVazquez/showtime

    A skill your agent uses when the user wants a video made, edited or finished: a launch or promo, product demo, explainer, trailer or teaser, tutorial or walkthrough, a screen recording turned into a…

    206 GitHub stars~3k tokensUpdated yesterday
    Media & CreativeAuto-check passed

More from digitalsamba/claude-code-video-toolkit

All 11 skills in this repo
  • FFmpeg for Video Production

    digitalsamba/claude-code-video-toolkit

    Command recipes for converting, resizing, compressing, trimming and extracting audio from video with FFmpeg, including settings for Remotion projects.

    2.2k GitHub starsUsed in 3 repos~3.3k tokens
    Auto-check passed
  • ElevenLabs Voiceover Generator

    digitalsamba/claude-code-video-toolkit

    Generates narration, sound effects and cloned voices through the ElevenLabs API, with model and setting choices tuned to the content's style.

    2.2k GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check: notes
  • LTX-2.3 Video Generation

    digitalsamba/claude-code-video-toolkit

    Generates roughly five-second video clips from a text prompt or a still image with the LTX-2.3 22B model, run through a Modal endpoint by `tools/ltx2.py`.

    2.2k GitHub starsUsed in 1 repo~2.4k tokens
    Auto-check: notes
  • Playwright Browser Demo Recording

    digitalsamba/claude-code-video-toolkit

    Records browser interactions as video with Playwright, covering viewport sizing, cursor highlighting, and converting output for Remotion.

    2.2k GitHub starsUsed in 1 repo~3.2k tokens
    Auto-check passed
  • Ideogram 4 Prompt Builder

    digitalsamba/claude-code-video-toolkit

    Turns a casual image request into the structured JSON caption Ideogram 4 needs for legible on-image text, exact brand colors and controlled layout.

    2.2k GitHub stars~1.3k tokensUpdated 4 days ago
    Auto-check: notes
  • moviepy Text-on-Video Composer

    digitalsamba/claude-code-video-toolkit

    Overlays deterministic, accurate text on AI-generated video clips and builds short single-file Python video projects without a Remotion toolchain.

    2.2k GitHub stars~3.3k tokensUpdated 4 days ago
    Auto-check passed

Questions about ACE-Step Music Generation

What does ACE-Step Music Generation do?

Generates background music, vocal tracks, covers and stems with ACE-Step 1.5 through a bundled music_gen.py tool, using cloud or self-hosted providers. 5, aimed at video production. It covers background music and soundtracks, songs with vocals and lyrics using structure tags, covers and style transfer, stem extraction, repainting a weak section of a track, and continuing or extending a track.

When should I use ACE-Step Music Generation?

ACE-Step Music Generation fits situations like: creating background music for a video from a short prompt; writing a song with vocals and lyrics; repainting a weak chorus or extending an existing track; extracting stems from a song.

How do I install ACE-Step Music Generation in Claude Code?

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

How do I install ACE-Step Music Generation in Codex?

Run `npx skills add digitalsamba/claude-code-video-toolkit --skill acestep -a codex`. Or copy the skill folder (.claude/skills/acestep in digitalsamba/claude-code-video-toolkit) into .agents/skills/acestep in your project. Codex loads it when a task matches its description.

Can I use ACE-Step Music Generation 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 digitalsamba/claude-code-video-toolkit --skill acestep -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/acestep, .gemini/skills/acestep, .github/skills/acestep and .opencode/skills/acestep in your project.

What does ACE-Step Music Generation need to run?

Going by SKILL.md and its folder, ACE-Step Music Generation needs the command-line tools its instructions call (uv) and credentials named ACEMUSIC_API_KEY. Our summary lists: An ACEMUSIC_API_KEY for the default cloud provider; uv, to run tools/music_gen.py; Modal or RunPod endpoint settings for self-hosted generation.

Does ACE-Step Music Generation access the network?

SKILL.md names 1 domain. In commands or code: acemusic.ai; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is ACE-Step Music Generation safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does ACE-Step Music Generation use?

ACE-Step Music Generation 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 ACE-Step Music Generation use?

About 3.3k tokens (SKILL.md is roughly 13k 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 ACE-Step Music Generation?

Skills that share tags, products or a category with ACE-Step Music Generation: VRGDG H3 Short Film Pipeline (vrgamegirl19/comfyui-vrgamedevgirl, 763 stars), Music to Video (heygen-com/hyperframes, 59k stars), Qiaomu Cut (joeseesun/qiaomu-cut-skill, 372 stars) and HyperFrames Audio (heygen-com/hyperframes, 59k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains ACE-Step Music Generation?

digitalsamba (a GitHub organization) maintains it in digitalsamba/claude-code-video-toolkit, which has 2,185 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 5, 2026.

Source: digitalsamba/claude-code-video-toolkit on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.