AI-Powered Personalized Song Maker Skill

About this skill

Solving a Specific Problem

Crafting a song tailored to a personal story for a special occasion traditionally involves multiple stages like lyric writing, composing, and arrangement, often requiring professional help at high cost and with unpredictable timelines. This skill automates the end-to-end process from story to song, enabling users to quickly generate customized, audible music by providing structured inputs, ideal for emotionally-driven scenarios like birthdays, weddings, or anniversaries.

How It Works: Core Capabilities and Key Steps

The skill implements a generative music creation pipeline with the following core capabilities and steps:

Input Collection and Story Structuring: The skill first collects a set of mandatory inputs, including the occasion, recipient, real story details to incorporate, required names or phrases, target language, emotional direction, and privacy omissions. It then structures this into a story map encompassing protagonist, relationship, turning points, core message, emotional arc, etc., laying the groundwork for lyric creation.
Free Creative Phase and User Confirmation: Before triggering any paid API calls, the skill performs free creative work. It generates a song title, a complete lyric draft with structure, and a production card describing genre, atmosphere, instrumentation, tempo, and vocal direction. Users can iteratively review and modify lyrics and direction at this stage at no cost until explicit confirmation is given.
API Call and Music Generation: After confirmation, the skill queries the beatra.models.list endpoint to check available music generation models, character limits, and billing. It then uses the bundled client scripts/mcp_client.py as an MCP client to submit one precise generation request to beatra.music.generate. This request includes the frozen title, lyrics, production prompts, and model parameters; one call constitutes one paid boundary.
Task Polling and Result Delivery: After submission, the skill obtains a task ID and polls via beatra.tasks.get until the task reaches a terminal state (success or failure). It delivers returned audio files or links and reports parsed model, segment count, duration, and usage. The skill also performs result review, checking for story accuracy, name pronunciation, chorus effectiveness, etc., and clearly communicates to the user what the AI can or cannot fully guarantee.

Applicability and Considerations

Focused on the Full Workflow: This skill is dedicated to the "story -> lyrics -> song" core route. If input is finished lyrics needing composition, use the "lyrics-to-music" workflow; for re-recording an existing song, use the "cover song" workflow; to create visuals for music, route to the "music short" workflow.
Clear Payment Model: Lyric writing, title drafting, and direction adjustments are free creative preparation. The sole point of payment occurs when the user confirms and calls beatra.music.generate to produce the song. Changing any confirmed core element (like title, lyrics, or model) is treated as a new logical payment request.
Strict State and Transaction Management: The skill relies on task IDs and phase IDs for state tracking. For lost requests or failed tasks, it provides recovery logic based on beatra.tasks.list and beatra.tasks.get, but strictly prohibits resubmitting a generation request without confirming the terminal state. Task states like "queued" and "running" are normal progress, not failures.

Editor's note

Written for AI Agent Hub. This is separate from the publisher description above.

What problem it solves

You have a personal story and you want lyrics, and maybe a sung rendering, for an occasion. The skill is a draft of that song. It is not a studio and it is not a clearance desk for melody rights.

Who it is for

Someone writing an original lyric from facts they have the right to use: their own anecdote, a fictional brief, a public-domain source they name. You will edit the draft before anyone hears it.

Who should skip it

Skip it if the prompt is "make it sound like this copyrighted song" or "continue this chapter I do not own." Content creation is where that mistake is common because the demo sounds fun. Skip it for a client jingle unless the contract allows a model to draft the copy. Skip it if you expected a unique recording you can register without further work. Generated audio can resemble training data. Listen before you publish.

First three steps

Write a five-line story that contains one concrete detail, such as a place name.
Ask for lyrics only, no extra verse about events you did not mention.
Check that the place name survived and that no celebrity or brand was added. If the chorus invents a biography, remove the skill or cut the prompt down to format instructions you write yourself.

Alternatives on this site

A writing-workflow skill on the same shelf is for long prose, not a chorus. Design-and-media skills make a page layout, not a song. Use those when the deliverable is not lyrics.

Questions

Can I paste a hit song as the style reference? Not if you intend to publish the result as yours. Describe the mood in words you own.

Does the directory host the audio? No. The card is a prompt. The audio, if any, is produced in your agent.

Screenshots

Use Cases

An event planner needs to generate an original song for a client's anniversary that incorporates specific memories, names, and an emotional tone as a surprise gift.
A marketing team lead needs to create an upbeat theme song with lyrics highlighting key product features for a new product launch event.
A family member wants to produce a warm, growth-themed song for a baby's first birthday that blends family anecdotes and future blessings.
An HR manager needs to create a customized company song for an employee retirement ceremony that reflects on their career and expresses gratitude.

Best For

Wedding Planners: Need to quickly generate exclusive wedding songs for each couple that incorporate love stories, vows, and ceremony flow.
Event Hosts: Need to create opening or background songs that enhance atmosphere and reflect themes for company annual meetings, celebrations, or team-building activities.
Content Creators: Want to produce unique original theme music for special series on video blogs or podcasts, such as character interviews or travel diaries.
Personal Gift Makers: Want to give a song written with a real story, unavailable on the market, as a birthday or anniversary gift for friends or family.