# jtydhr88/music-composition-skills architecture

> Architecture diagram of the GitHub repository jtydhr88/music-composition-skills, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jtydhr88/music-composition-skills
- Repository: https://github.com/jtydhr88/music-composition-skills

## Overview

This repository is a library of agent skills for composing and arranging popular music, not a music-generation engine. The documented workflow turns a user brief into an ARR-SPEC, then compiles that specification into handoff formats and an acceptance baseline. The graph preserves major documented composition, style, arrangement, and review capabilities. Relationships are based on the README; skill internals were not sampled, so undocumented call wiring is omitted.

Main entry points: [`plugins/music-composition/skills/mc-workflow/SKILL.md`](https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-workflow/SKILL.md) (Workflow skill), [`plugins/music-composition/skills/mc-render-compile/SKILL.md`](https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-render-compile/SKILL.md) (Render compiler), [`plugins/music-composition/skills/mc-workflow/ARR-SPEC.schema.md`](https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-workflow/ARR-SPEC.schema.md) (ARR-SPEC), [`plugins/music-composition/skills/mc-form/SKILL.md`](https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-form/SKILL.md) (Form and structure)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Workflow and spec"]
  node_workflow_skill["Workflow skill<br/>[SKILL.md]"]
  node_arr_spec["ARR-SPEC<br/>[ARR-SPEC.schema.md]"]
  node_compiler["Render compiler<br/>[SKILL.md]"]
  node_handoff["Compiled handoff"]
end

subgraph group_composition["Composition craft"]
  node_form["Form and structure<br/>[SKILL.md]"]
  node_harmony["Harmony and progressions<br/>[SKILL.md]"]
  node_melody["Melody and development<br/>[SKILL.md]"]
  node_counterpoint["Counterpoint<br/>[SKILL.md]"]
  node_rhythm["Rhythm and groove<br/>[SKILL.md]"]
end

subgraph group_arrangement["Arrangement and sound"]
  node_arrangement["Arrangement architecture<br/>[SKILL.md]"]
  node_orchestration["Orchestration<br/>[SKILL.md]"]
  node_texture["Texture layering<br/>[SKILL.md]"]
  node_rhythm_section["Rhythm section<br/>[SKILL.md]"]
  node_vocal["Vocal direction<br/>[SKILL.md]"]
  node_mix["Mix intent<br/>[SKILL.md]"]
  node_sound["Sound design<br/>[SKILL.md]"]
end

subgraph group_review["Review and styles"]
  node_styles["Genre style skills"]
  node_audit["AI-tell audit<br/>[SKILL.md]"]
  node_case_studies["Case studies<br/>[SKILL.md]"]
  node_score["Symbolic score<br/>[SKILL.md]"]
end

node_user(("User"))
node_generation(("Music generation model"))

node_user -->|"provides brief"| node_workflow_skill
node_workflow_skill -->|"routes to"| node_form
node_workflow_skill -->|"routes to"| node_harmony
node_workflow_skill -->|"routes to"| node_melody
node_workflow_skill -->|"routes to"| node_counterpoint
node_workflow_skill -->|"routes to"| node_rhythm
node_workflow_skill -->|"routes to"| node_arrangement
node_workflow_skill -->|"routes to"| node_orchestration
node_workflow_skill -->|"routes to"| node_texture
node_workflow_skill -->|"routes to"| node_rhythm_section
node_workflow_skill -->|"routes to"| node_vocal
node_workflow_skill -->|"routes to"| node_mix
node_workflow_skill -->|"routes to"| node_sound
node_workflow_skill -->|"routes to"| node_styles
node_workflow_skill -->|"fills"| node_arr_spec
node_arr_spec -->|"provides spec"| node_compiler
node_compiler -->|"compiles"| node_handoff
node_compiler -->|"can emit ABC"| node_score
node_handoff -->|"provides input"| node_generation
node_workflow_skill -->|"can invoke"| node_audit
node_workflow_skill -->|"can consult"| node_case_studies

click node_workflow_skill "https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-workflow/SKILL.md"
click node_arr_spec "https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-workflow/ARR-SPEC.schema.md"
click node_compiler "https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-render-compile/SKILL.md"
click node_form "https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-form/SKILL.md"
click node_harmony "https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-harmony/SKILL.md"
click node_melody "https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-melody/SKILL.md"
click node_counterpoint "https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-counterpoint/SKILL.md"
click node_rhythm "https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-rhythm-groove/SKILL.md"
click node_arrangement "https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-arrangement-arch/SKILL.md"
click node_orchestration "https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-orchestration/SKILL.md"
click node_texture "https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-texture-layering/SKILL.md"
click node_rhythm_section "https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-rhythm-section/SKILL.md"
click node_vocal "https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-vocal-direction/SKILL.md"
click node_mix "https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-mix-intent/SKILL.md"
click node_sound "https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-sound-design/SKILL.md"
click node_styles "https://github.com/jtydhr88/music-composition-skills/tree/main/plugins/music-composition/skills"
click node_audit "https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-ai-tell-audit/SKILL.md"
click node_case_studies "https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-case-studies/SKILL.md"
click node_score "https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-symbolic-score/SKILL.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_workflow_skill,node_arr_spec,node_compiler,node_handoff,node_user toneBlue
class node_form,node_harmony,node_melody,node_counterpoint,node_rhythm toneAmber
class node_arrangement,node_orchestration,node_texture,node_rhythm_section,node_vocal,node_mix,node_sound toneMint
class node_styles,node_audit,node_case_studies,node_score toneRose
class node_generation toneIndigo
```

## Components

### Workflow and spec

- [Workflow skill](https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-workflow/SKILL.md): `plugins/music-composition/skills/mc-workflow/SKILL.md`
- [ARR-SPEC](https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-workflow/ARR-SPEC.schema.md): `plugins/music-composition/skills/mc-workflow/ARR-SPEC.schema.md`
- [Render compiler](https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-render-compile/SKILL.md): `plugins/music-composition/skills/mc-render-compile/SKILL.md`
- **Compiled handoff**

### Composition craft

- [Form and structure](https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-form/SKILL.md): `plugins/music-composition/skills/mc-form/SKILL.md`
- [Harmony and progressions](https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-harmony/SKILL.md): `plugins/music-composition/skills/mc-harmony/SKILL.md`
- [Melody and development](https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-melody/SKILL.md): `plugins/music-composition/skills/mc-melody/SKILL.md`
- [Counterpoint](https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-counterpoint/SKILL.md): `plugins/music-composition/skills/mc-counterpoint/SKILL.md`
- [Rhythm and groove](https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-rhythm-groove/SKILL.md): `plugins/music-composition/skills/mc-rhythm-groove/SKILL.md`

### Arrangement and sound

- [Arrangement architecture](https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-arrangement-arch/SKILL.md): `plugins/music-composition/skills/mc-arrangement-arch/SKILL.md`
- [Orchestration](https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-orchestration/SKILL.md): `plugins/music-composition/skills/mc-orchestration/SKILL.md`
- [Texture layering](https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-texture-layering/SKILL.md): `plugins/music-composition/skills/mc-texture-layering/SKILL.md`
- [Rhythm section](https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-rhythm-section/SKILL.md): `plugins/music-composition/skills/mc-rhythm-section/SKILL.md`
- [Vocal direction](https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-vocal-direction/SKILL.md): `plugins/music-composition/skills/mc-vocal-direction/SKILL.md`
- [Mix intent](https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-mix-intent/SKILL.md): `plugins/music-composition/skills/mc-mix-intent/SKILL.md`
- [Sound design](https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-sound-design/SKILL.md): `plugins/music-composition/skills/mc-sound-design/SKILL.md`

### Review and styles

- [Genre style skills](https://github.com/jtydhr88/music-composition-skills/tree/main/plugins/music-composition/skills): `plugins/music-composition/skills`
- [AI-tell audit](https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-ai-tell-audit/SKILL.md): `plugins/music-composition/skills/mc-ai-tell-audit/SKILL.md`
- [Case studies](https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-case-studies/SKILL.md): `plugins/music-composition/skills/mc-case-studies/SKILL.md`
- [Symbolic score](https://github.com/jtydhr88/music-composition-skills/blob/main/plugins/music-composition/skills/mc-symbolic-score/SKILL.md): `plugins/music-composition/skills/mc-symbolic-score/SKILL.md`

### Other components

- **User**
- **Music generation model**

## Connections

- User → Workflow skill: provides brief
- Workflow skill → Form and structure: routes to
- Workflow skill → Harmony and progressions: routes to
- Workflow skill → Melody and development: routes to
- Workflow skill → Counterpoint: routes to
- Workflow skill → Rhythm and groove: routes to
- Workflow skill → Arrangement architecture: routes to
- Workflow skill → Orchestration: routes to
- Workflow skill → Texture layering: routes to
- Workflow skill → Rhythm section: routes to
- Workflow skill → Vocal direction: routes to
- Workflow skill → Mix intent: routes to
- Workflow skill → Sound design: routes to
- Workflow skill → Genre style skills: routes to
- Workflow skill → ARR-SPEC: fills
- ARR-SPEC → Render compiler: provides spec
- Render compiler → Compiled handoff: compiles
- Render compiler → Symbolic score: can emit ABC
- Compiled handoff → Music generation model: provides input
- Workflow skill → AI-tell audit: can invoke
- Workflow skill → Case studies: can consult