English | 한국어

Music Composition Agent Skill

A modular knowledge and workflow skill for an AI music-composition assistant.

This repository is designed to help an agent turn vague creative requests — “make the chorus hit harder,” “give me a darker K-pop bridge,” “reharmonize this like jazz but not too dense,” “find reference tracks for my playlist” — into concrete musical decisions: chords, melody shapes, grooves, forms, arrangement moves, diagnostic feedback, and research workflows.

Current release: v1.0
Release date: 2026-04-27

Installation

The simplest way is via the skills CLI (requires Node.js):

npx skills add SJY051/music-composition

This installs to your current project's agent directory (e.g., .claude/skills/). Add -g for user-level (global) install, or --all -y to skip prompts.

For a manual install, clone the repository and point your agent at it (or copy SKILL.md and the relevant subdirectories into your agent's skill folder, such as ~/.claude/skills/ or .claude/skills/ in a project):

git clone https://github.com/SJY051/music-composition.git

Compatibility

The skill follows the open Agent Skills standard — the SKILL.md + YAML frontmatter format used by both Claude (Claude Code, Claude Agent SDK, Claude.ai skills) and OpenAI (Responses API tools[].environment.skills). It works on any harness that reads this format.

Does it work?

Two benchmarks ship with v1.0:

Approach 1 (system-prompt injection, GLM-5.1, blind eval). With SKILL.md prepended to the system prompt, the skill version wins 6 of 8 representative composition prompts in an author-bias-controlled blind comparison. The strongest signal is the boundary test (P8) — the skill version explicitly declines an out-of-scope mixing question while the baseline answers freely.

Approach 2 (native lazy loading, Claude Opus 4.7). With the skill installed via Claude Desktop's Skills feature, the model reads references on demand. Most striking: pansori OST advice cites yoseong, toeseong, chuseong with cents-and-milliseconds implementation values that exist only inside references/genres/korean-traditional.md — direct evidence the model used the skill's full content, not just SKILL.md.

Together: the skill content shapes behavior even on weaker setups, and content depth unlocks on stronger setups. Full methodology and per-prompt analysis: benchmarks/v1.0-eval.md, benchmarks/v1.0-claude.md.

What this skill is for

Use this skill when an AI agent needs to help with:

• composition brainstorming
• chord progressions and harmonic direction
• melody, motif, phrase, and topline writing
• song forms, transitions, and narrative structure
• rhythm, groove, meter, and feel
• orchestration, arrangement, voicing, and instrument idiom
• genre-aware writing across pop, jazz, classical, game, media, regional, traditional, and hybrid styles
• critique and revision of a work in progress
• teaching music concepts in a practical composition-first way
• current music trend research and reference-track digging
• user-agent collaborative workflows across multiple turns