beatra-ai/beatra-skills/ai-song-cover-studio
Claude Code and agent skill by beatra-ai/beatra-skills
- community
Checking that the SKILL.md file is still in the repository.
Turn a song recording into a newly interpreted cover or rearranged song from a reference performance and a fresh genre, arrangement, and vocal direction. This AI song cover studio and reference-audio cover generator reinterprets a classic song as rock, acoustic, folk, jazz, Chinese-style, ballad, or a new vocal character, and reviews recognizable reference influence, arrangement freshness, vocal delivery, lyrics, pronunciation, and structure. Use it for classic-song reinterpretation, genre swaps, creator demos, tribute performances, and personal practice recordings, with one cover generation per run and honest post-result review.
Install
npx vskill@latest install beatra-ai/beatra-skills/ai-song-cover-studioSKILL.md
The same SKILL.md was published earlier as beatra-ai/beatra-skills/ai-song-cover-studio.
AI Song Cover Studio
Turn one accessible song recording into a newly interpreted cover or rearranged song. Use this Skill when the user already has a reference song and asks for a cover, classic-song reinterpretation, genre change, acoustic version, rock version, Chinese-style arrangement, a fresh vocal or performance direction, or a reimagined arrangement of an existing track.
Scope and adjacent routes
The normal route is one reference song recording, one reinterpretation direction, and one new cover. Route a request that starts with a story and no finished lyrics or song to a personalized-song workflow; a request that begins with finished lyrics to a lyrics-to-song workflow; and a request that begins with finished music and needs visuals to a music-video workflow. Keep this route focused on whole-song reinterpretation of one reference recording.
Inputs and defaults
The hard inputs are:
- one accessible reference song recording (FLAC, MP3, or WAV) the host Agent can inspect;
- the desired reinterpretation direction — a genre change, new arrangement, fresh vocal character, or reimagined mood.
Ask only for a missing hard input. Reuse the known language, mood, instrumentation, vocal character, and must-keep details. Beatra has no lyrics-transcription step: any lyric text that must be preserved accurately must be supplied and approved by the user before generation.
For a local reference file the host Agent can access, use the bundled upload helper only after inspection:
Upload is transport, not creative review. Retain the returned artifact reference and never pass a local path to a remote tool.
Prepare a short production card before any paid call: song identity, language, mood, target genre, energy, instrumentation, vocal character, must-keep lyrical details, and the desired degree of reinterpretation. Default to one cover generation and model: "auto". Build one positive reinterpretation instruction that states the single dominant creative change this run should deliver.
Golden path
- Inspect the reference recording. Record its actual MIME type, format, duration, and byte size. Identify the song identity, language, mood, genre, energy, instrumentation, vocal character, source-audio intent, and the requested reinterpretation direction.
- Build a production card: song identity, language, mood, target genre, energy, instrumentation, vocal character, must-keep lyrical details, and desired degree of reinterpretation. Then write one positive reinterpretation instruction that states the single dominant creative change.
- Call
beatra.models.listwith{"capability":"reference_audio_to_music"}to confirm a current card admits the reference recording's actual MIME type, format, duration, and byte size. Confirm the live duration and byte-size limits, the accepted reference-audio route, and the price basis. Keep the model atautounless the user chose a concrete eligible model or the requested route requires an explicit model family. - Route the reinterpretation explicitly and show the user the exact route, reference recording, production prompt, lyrics and title when supplied, model behavior, and paid boundary:
- vocal reinterpretation without supplied lyrics: use a supported reference-audio card and a concise production prompt; do not claim exact lyric preservation;
- vocal reinterpretation with user-supplied lyrics: the current
autoreference route requires a 10–300-character prompt; supplied lyrics must contain 10–1000 characters and require a nonempty title; - instrumental reinterpretation: do not use
model: "auto"; select an explicit live model family that affirmatively supports this combination; - model-family controls: send only controls published by the chosen live family and never mix family-specific options.
- Show the confirmation card below and wait for the user's reply. After they approve it, freeze the route, reference recording, production prompt, lyrics and title when supplied, model, and paid boundary with one opaque stable
client_request_id; then submit onebeatra.music.generatecall exactly once. Invoke only the bundledscripts/mcp_client.py: the MCP tool name is the CLI argument and its arguments are JSON on standard input. For example:
``text printf '%s' '{"reference_audio":{"type":"artifact","artifact_id":"art_reference"},"prompt":"Reimagine this ballad as an upbeat acoustic folk cover with warm vocals and a lighter, brighter arrangement.","client_request_id":"opaque-cover-id"}' | python3 scripts/mcp_client.py call beatra.music.generate ``
Do not configure, call, or use a host Beatra Connector. Do not use REST/OpenAPI fallback. Submit beatra.music.generate exactly once.
- Record the returned task ID immediately and poll the same task with
beatra.tasks.getuntil terminal. Deliver every returned audio artifact or link. Report only actual returned task status, resolved model, duration, usage, andbilling.net_charged_credits. Review accessible output for recognizable reference influence, freshness of arrangement, vocal delivery, lyrics, pronunciation, structure, and actual duration. State what the host Agent could and could not inspect. - After the user has heard the cover, and only when this account has the music tools (the bundled client's
toolscommand listsbeatra.music.editandbeatra.audio.process; see music editing and audio), offer its backing version. Offer a re-sung version only when the user wants new words or a new voice, and only after they heard the backing version or have an instrumental of their own. These are two paid steps, each its own call on its own card, with the live price for that step frombeatra.models.list(capabilityaudio_stem_separationormusic_add_vocals) and its ownclient_request_id; neither rides on the cover's card.
- A backing (instrumental) version of the cover is
beatra.audio.processoperation: "separate_stems"withmode: "two_stem", taking theinstrumentaloutput. A newly generated instrumental through the instrumental reinterpretation route above stays the alternative, as a new piece rather than the cover without vocals. - A re-sung version over an instrumental is
beatra.music.editwithoperation: "add_vocals", the instrumental (the backing version, or one the user supplies) assource, and the user's approvedlyrics, which are required. Beatra has no lyrics-transcription step, so the lyrics come from the user. A backing version split from the cover keeps faint traces of the cover's vocals, which stay under the new vocals: say so before this call.
Confirm before each paid call
Before every paid call (the cover and each follow-up step above), show a current confirmation card and wait for the user's reply:
- Work — what this call makes, in the user's words, and which kind of call it is (a new generation for the cover, a split for the backing version, a vocal edit for a re-sung version).
- Credits — the live price for this step, just read from
beatra.models.list(the capability step 3 read for the cover;audio_stem_separationormusic_add_vocalsfor a follow-up; for the two-stem backing split, theaudio_stem_separationprice option withoutdimensions). Never a remembered number. - Count — one paid call.
- Identity — one new opaque
client_request_idfor this step. Any changed argument mints a new ID. - If we stop here — the production card and everything already delivered stay usable.
- If the balance is insufficient — relay the official message and its top-up URL exactly. Translate the prose; keep the URL. Do not retry until the user says they have topped up.
Paid changes, recovery, and cancellation
A cover is one paid stage, and each follow-up above is another. A revised reference recording, production prompt, supplied lyrics or title, genre, arrangement, vocal direction, model, or control is new logical paid work with a new ID and fresh approval.
If a create response is lost, retry only the identical frozen payload with the same stage ID. If a task ID is lost, call beatra.tasks.list for the relevant capability, inspect plausible candidates with beatra.tasks.get, and match them against that stage's private ledger before considering an identical retry. Queued and running are progress states, not failures. Recover the original stage before planning changed work; never duplicate a paid submission or guess its charge or refund.
Call beatra.tasks.cancel only when the user asks to cancel. Call it once and confirm the resulting terminal state with beatra.tasks.get. A 409 means cancellation is not confirmed, so continue polling that same task without creating replacement work.
If the tool returns insufficient credits: give the user the tool message in full. Do not change the URL. You may translate the other words. Do not replace it with your own top-up copy. Point the user to pay using that message.
When the user asks how many credits remain, call beatra.wallet.get. When they ask what was charged, call beatra.wallet.ledger. Both are read-only. Do not invent an account-balance or top-up tool. Do not make wallet.get a required step before every paid submit.
References by task
- Read Song cover workflow when building a production card, choosing the reference-audio route, checking live model facts, constructing exact payloads, polling, recovering, cancelling, or reviewing arrangement and vocal results.
- Read Music editing and audio when the user wants a backing version of the cover or a re-sung version over an instrumental.
- Read Installation and authentication only when authorization or shared credentials need attention.
- Read Installation registration for the non-billable best-effort package registration step.
- Read Tasks and results for shared terminal task and artifact semantics, and Billing, errors, and recovery for returned billing or error details.
- Read Bundled MCP Client diagnostics when the bundled client cannot connect. Do not configure a host Connector.
- Updates and security: updates and security
- Read Uninstall and disconnect only when the user asks to remove the package or shared credentials.
Use or invoke the bundled scripts/mcp_client.py for every Beatra operation.
Updates and security
This Skill runs only the files installed with it and leaves them unchanged while it runs; it never downloads or executes other code. It talks to Beatra's official services over HTTPS, and a file you choose to upload goes only to the one-time upload address Beatra issues for it.
Once a day at most, the bundled client reads Beatra's public version list. When the store or tool you installed from has a newer version, it prints one line with the command that updates it there. Updating stays your choice, through that store or tool. See updates and security.
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewNot runA model review is scheduled for the next rescan.
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/ai-song-cover-studio/SKILL.md
Popularity
- Repository stars
- 2
- 7-day trend score
- 10
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/beatra-ai/beatra-skills/ai-song-cover-studio)