# leonxlnx/cinetic architecture

> Architecture diagram of the GitHub repository leonxlnx/cinetic, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/leonxlnx/cinetic
- Repository: https://github.com/leonxlnx/cinetic

## Overview

cinetic is an agent skill for directing and producing short, branded launch films and motion designs. The agent develops and selects a concept, draws techniques, establishes a visual identity, and builds a film in Remotion by default or HyperFrames. Picture cues also drive synthesized music and sound effects; finishing and QA check the rendered result before delivery. The graph follows the documented workflow and capabilities. Several script relationships are documented in the README or SOURCE INDEX; unsampled implementation details are not inferred.

Main entry points: [`skills/cinetic/SKILL.md`](https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/SKILL.md) (Film direction skill), [`skills/cinetic/scripts/render.sh`](https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/scripts/render.sh) (Render finishing), [`skills/cinetic/assets/remotion-starter/src/Film.tsx`](https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/assets/remotion-starter/src/Film.tsx) (Film composition), [`skills/cinetic/scripts/audio/score.py`](https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/scripts/audio/score.py) (Score composition)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_direction["Direction and design"]
  node_skill["Film direction skill<br/>[SKILL.md]"]
  node_treatment["Concept and treatment<br/>[TREATMENT.md]"]
  node_techniques[("Technique library<br/>[techniques.json]")]
  node_picker["Technique picker<br/>[pick.py]"]
  node_brand["Brand design<br/>[brand-kit.sh]"]
  node_palette["Palette design<br/>[palette.py]"]
end

subgraph group_production["Film production"]
  node_film["Film composition<br/>[Film.tsx]"]
  node_hyperframes["HyperFrames engine"]
  node_cues["Cue export<br/>[export-cues.ts]"]
  node_blur["Motion blur planning<br/>[measure-speed.py]"]
end

subgraph group_sound["Sound and finishing"]
  node_score["Score composition<br/>[score.py]"]
  node_synth["Audio synthesis<br/>[synth.py]"]
  node_master["Audio mastering<br/>[master.py]"]
  node_render["Render finishing<br/>[render.sh]"]
end

subgraph group_review["Review and delivery"]
  node_audit["Audio-video audit<br/>[av-audit.py]"]
  node_forensics["Pixel forensics<br/>[forensics.py]"]
  node_contact["Contact sheets<br/>[sheet.py]"]
  node_critics["Critic review"]
  node_linter["Film linter<br/>[lint-film.mjs]"]
  node_delivery["Deliverables<br/>[deliver.sh]"]
end

node_agent(("Coding agent"))

node_agent -->|"requests film"| node_skill
node_skill -->|"develops concept"| node_treatment
node_skill -->|"draws techniques"| node_picker
node_picker -->|"reads library"| node_techniques
node_skill -->|"establishes brand"| node_brand
node_brand -.->|"builds palette"| node_palette
node_skill -->|"builds picture"| node_film
node_skill -.->|"can target"| node_hyperframes
node_film -->|"exports cues"| node_cues
node_film -.->|"supplies motion"| node_blur
node_cues -->|"drives sound"| node_score
node_score -->|"uses instruments"| node_synth
node_score -->|"masters mix"| node_master
node_film -->|"renders picture"| node_render
node_render -->|"checks mux"| node_audit
node_render -->|"checks pixels"| node_forensics
node_render -->|"makes sheets"| node_contact
node_audit -->|"replays plan"| node_score
node_audit -->|"uses analysis"| node_forensics
node_contact -->|"uses analysis"| node_forensics
node_skill -->|"enforces bans"| node_linter
node_skill -->|"runs critic passes"| node_critics
node_critics -->|"gates shipment"| node_delivery
node_render -.->|"prepares masters"| node_delivery

click node_skill "https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/SKILL.md"
click node_treatment "https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/assets/TREATMENT.md"
click node_techniques "https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/assets/library/techniques.json"
click node_picker "https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/scripts/pick.py"
click node_brand "https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/scripts/brand-kit.sh"
click node_palette "https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/scripts/palette.py"
click node_film "https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/assets/remotion-starter/src/Film.tsx"
click node_hyperframes "https://github.com/leonxlnx/cinetic/tree/main/skills/cinetic/assets/hyperframes-starter"
click node_cues "https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/scripts/export-cues.ts"
click node_blur "https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/scripts/measure-speed.py"
click node_score "https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/scripts/audio/score.py"
click node_synth "https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/scripts/audio/synth.py"
click node_master "https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/scripts/audio/master.py"
click node_render "https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/scripts/render.sh"
click node_audit "https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/scripts/av-audit.py"
click node_forensics "https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/scripts/forensics.py"
click node_contact "https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/scripts/sheet.py"
click node_critics "https://github.com/leonxlnx/cinetic/tree/main/skills/cinetic/assets/critics"
click node_linter "https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/scripts/lint-film.mjs"
click node_delivery "https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/scripts/deliver.sh"

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_skill,node_treatment,node_techniques,node_picker,node_brand,node_palette toneBlue
class node_film,node_hyperframes,node_cues,node_blur toneAmber
class node_score,node_synth,node_master,node_render toneMint
class node_audit,node_forensics,node_contact,node_critics,node_linter,node_delivery toneRose
class node_agent toneIndigo
```

## Components

### Direction and design

- [Film direction skill](https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/SKILL.md): `skills/cinetic/SKILL.md`
- [Concept and treatment](https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/assets/TREATMENT.md): `skills/cinetic/assets/TREATMENT.md`
- [Technique library](https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/assets/library/techniques.json): `skills/cinetic/assets/library/techniques.json`
- [Technique picker](https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/scripts/pick.py): `skills/cinetic/scripts/pick.py`
- [Brand design](https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/scripts/brand-kit.sh): `skills/cinetic/scripts/brand-kit.sh`
- [Palette design](https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/scripts/palette.py): `skills/cinetic/scripts/palette.py`

### Film production

- [Film composition](https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/assets/remotion-starter/src/Film.tsx): `skills/cinetic/assets/remotion-starter/src/Film.tsx`
- [HyperFrames engine](https://github.com/leonxlnx/cinetic/tree/main/skills/cinetic/assets/hyperframes-starter): `skills/cinetic/assets/hyperframes-starter`
- [Cue export](https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/scripts/export-cues.ts): `skills/cinetic/scripts/export-cues.ts`
- [Motion blur planning](https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/scripts/measure-speed.py): `skills/cinetic/scripts/measure-speed.py`

### Sound and finishing

- [Score composition](https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/scripts/audio/score.py): `skills/cinetic/scripts/audio/score.py`
- [Audio synthesis](https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/scripts/audio/synth.py): `skills/cinetic/scripts/audio/synth.py`
- [Audio mastering](https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/scripts/audio/master.py): `skills/cinetic/scripts/audio/master.py`
- [Render finishing](https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/scripts/render.sh): `skills/cinetic/scripts/render.sh`

### Review and delivery

- [Audio-video audit](https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/scripts/av-audit.py): `skills/cinetic/scripts/av-audit.py`
- [Pixel forensics](https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/scripts/forensics.py): `skills/cinetic/scripts/forensics.py`
- [Contact sheets](https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/scripts/sheet.py): `skills/cinetic/scripts/sheet.py`
- [Critic review](https://github.com/leonxlnx/cinetic/tree/main/skills/cinetic/assets/critics): `skills/cinetic/assets/critics`
- [Film linter](https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/scripts/lint-film.mjs): `skills/cinetic/scripts/lint-film.mjs`
- [Deliverables](https://github.com/leonxlnx/cinetic/blob/main/skills/cinetic/scripts/deliver.sh): `skills/cinetic/scripts/deliver.sh`

### Other components

- **Coding agent**

## Connections

- Coding agent → Film direction skill: requests film (evidence: `README.md`)
- Film direction skill → Concept and treatment: develops concept (evidence: `README.md`)
- Film direction skill → Technique picker: draws techniques (evidence: `README.md`)
- Technique picker → Technique library: reads library (evidence: `skills/cinetic/scripts/pick.py`)
- Film direction skill → Brand design: establishes brand (evidence: `README.md`)
- Brand design → Palette design: builds palette
- Film direction skill → Film composition: builds picture (evidence: `README.md`)
- Film direction skill → HyperFrames engine: can target (evidence: `README.md`)
- Film composition → Cue export: exports cues (evidence: `README.md`)
- Film composition → Motion blur planning: supplies motion (evidence: `skills/cinetic/scripts/measure-speed.py`)
- Cue export → Score composition: drives sound (evidence: `skills/cinetic/scripts/audio/score.py`)
- Score composition → Audio synthesis: uses instruments (evidence: `skills/cinetic/scripts/audio/score.py`)
- Score composition → Audio mastering: masters mix (evidence: `skills/cinetic/scripts/audio/score.py`)
- Film composition → Render finishing: renders picture (evidence: `README.md`)
- Render finishing → Audio-video audit: checks mux (evidence: `README.md`)
- Render finishing → Pixel forensics: checks pixels (evidence: `README.md`)
- Render finishing → Contact sheets: makes sheets (evidence: `README.md`)
- Audio-video audit → Score composition: replays plan (evidence: `skills/cinetic/scripts/av-audit.py`)
- Audio-video audit → Pixel forensics: uses analysis (evidence: `skills/cinetic/scripts/av-audit.py`)
- Contact sheets → Pixel forensics: uses analysis (evidence: `skills/cinetic/scripts/sheet.py`)
- Film direction skill → Film linter: enforces bans (evidence: `README.md`)
- Film direction skill → Critic review: runs critic passes (evidence: `README.md`)
- Critic review → Deliverables: gates shipment (evidence: `README.md`)
- Render finishing → Deliverables: prepares masters
