music-generation

Use this skill when the user requests to generate, create, compose, or produce music or songs — background music, theme songs, jingles, or instrumental tracks. Generates a song from a style/mood prompt and optional lyrics via the MiniMax music API.

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Critical

Do not install without reviewing

Quality

Content

86%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A clean, actionable skill body with a real executable command, a complete spec example, and good structure that keeps the script external. The main gap is the absence of an explicit output-verification step in the workflow, though the operation is non-destructive and the script self-reports failures.

Suggestions

Add an explicit verification checkpoint after Step 3 (e.g., confirm the MP3 exists at --output-file and check the script's stdout for 'Successfully generated' vs an error before calling present_files).

Trim the Overview's restatement of the frontmatter description to avoid mild duplication with the 'what' already covered above.

Show a one-line instrumental variant of the spec JSON (is_instrumental: true) alongside the vocal example so both common cases are copy-paste ready.

Dimension	Reasoning	Score
Conciseness	The body is lean and assumes Claude's competence — no explaining what music, APIs, or JSON are — with every section earning its place; the Overview mildly re-states the frontmatter description and a few field notes could be tightened, so it stops just short of a 5.	4 / 5
Actionability	Fully executable guidance: a complete JSON spec example with all fields, and a copy-paste bash command whose --prompt-file/--output-file flags match the real generate.py argparse, plus explicit present_files handoff for the output.	5 / 5
Workflow Clarity	Clear three-step sequence (Understand → Create spec → Execute) with the script self-reporting errors, but no explicit verification checkpoint such as confirming the MP3 was written or checking the command's exit output before sharing.	4 / 5
Progressive Disclosure	Well-organized into Overview/Workflow/Environment/Output Handling/Notes with the only bundle file (scripts/generate.py) kept external and clearly invoked via an absolute command path rather than inlined; no nested references and easy to navigate.	5 / 5
	Total	18 / 20 Passed

Description

95%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description that clearly states both what the skill does and when to use it, with rich natural trigger terms and a distinct niche. The only minor weakness is that the listed action verbs are synonyms of a single capability rather than multiple distinct operations.

Dimension	Reasoning	Score
Specificity	Lists several concrete actions and output types ('generate, create, compose, or produce music or songs — background music, theme songs, jingles, or instrumental tracks') and the mechanism ('Generates a song from a style/mood prompt and optional lyrics'), but the verbs are largely synonymous framings of one action rather than genuinely distinct operations, leaving minor coverage gaps versus a 5.	4 / 5
Completeness	Explicitly answers both — the 'when' via 'Use this skill when the user requests to generate... music or songs — background music, theme songs, jingles, or instrumental tracks' and the 'what' via 'Generates a song from a style/mood prompt and optional lyrics via the MiniMax music API'.	5 / 5
Trigger Term Quality	Comprehensive natural trigger coverage with synonyms users actually say ('generate, create, compose, or produce music or songs', 'background music', 'theme songs', 'jingles', 'instrumental tracks'); no meaningful file-extension trigger applies to this domain.	5 / 5
Distinctiveness Conflict Risk	Music/song generation is a clear niche with distinct triggers (background music, theme songs, jingles, instrumentals) and a named API, making conflict with other skills minimal.	5 / 5
	Total	19 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: bytedance/deer-flow
Path: skills/public/music-generation/SKILL.md
Commit: 2a261d2

Reviewed: about 15 hours ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.