Solmi

Skill Solmi-AI/solmi-skills/skills/solmi

Use when an AI agent needs to create AI-generated songs or full AI music videos, check Solmi account credits, or poll generation status. Works through the `solmi` CLI (installed via npm) against solmi.ai.From its SKILL.md

Install

npx -y skills add Solmi-AI/solmi-skills --skill solmi

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

2.9 KB, 700 tokens by cl100k_base, as published. Nobody here has run it

Solmi Skill

Create AI songs and cinematic AI music videos from the terminal via solmi.ai.

Step 1: Ensure the CLI is available

Check: solmi --version. If missing, install it:

npm install -g solmi-cli        # or use `npx solmi-cli ...` per-command

Requires Node.js 18+.

Step 2: Check authentication

solmi whoami --output json

Exit code 0: signed in; the JSON includes plan, credits (songs), and musicVideoCredits.
Exit code 3: not signed in. Run solmi login — it prints a code and a https://solmi.ai/cli-auth?... URL and opens the browser. On headless machines use solmi login --headless and show the user the URL + code so they can approve from any device. Wait for the command to finish before continuing.

Step 3: Commands

Task	Command
Account, plan, credit balances	`solmi whoami --output json`
Generate a song from an idea	`solmi song create --description "..." [--title t] [--style Pop] --output json`
Generate a song from full lyrics	`solmi song create --prompt "<lyrics>" --title t --style "R&B" --output json`
Instrumental track	add `--instrumental`
Check a song / get audio URL	`solmi song status <id> --output json` (`--wait` blocks until done)
Full AI music video from a Solmi song	`solmi video create --song <songId> --style "Cinematic" [--intent "creative direction"] --output json`
Music video from any audio URL	`solmi video create --audio <url> --style "Anime" --output json`
Check a video / get video URL	`solmi video status <id> --output json` (`--wait` blocks; renders take many minutes)

Song generation takes ~1–3 minutes and by default the create command waits and prints the final audioUrl. Music videos run a full autopilot pipeline (brief → shot list → storyboard → render → export) and can take 15–45 minutes; prefer --no-wait plus periodic solmi video status <id> checks.

Output contract

Results print to stdout; progress/logs print to stderr.
Always pass --output json when parsing.
Exit codes: 0 success, 1 general error, 2 validation error, 3 auth required, 4 network error.

Costs and safety

A song costs 5 credits. Music videos charge fixed planning steps plus per rendered second from the musicVideoCredits pool. Failed generations are refunded automatically.
Mutating commands spend the user's real credits. Always get explicit user confirmation before running solmi song create or solmi video create, and state the expected cost. Read-only commands (whoami, status) may run freely.
Never print or store the contents of ~/.solmi/config.json (it holds the auth token).

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.