# yildizdikme/claude-video-edit architecture

> Architecture diagram of the GitHub repository yildizdikme/claude-video-edit, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yildizdikme/claude-video-edit
- Repository: https://github.com/yildizdikme/claude-video-edit

## Overview

This repository is a Claude Code video-editing skill backed by scripts and a browser-based scene template. The principal workflow is collaborative: Claude transcribes clips and prepares a word-aware rough cut, the creator reviews and revises it, then chapter graphics and optional sound effects are rendered and mixed into a final video. The graph preserves documented review, profile, loudness, and verification capabilities. Some script relationships are supported by the source index; unsampled implementation details are not inferred.

Main entry points: [`SKILL.md`](https://github.com/yildizdikme/claude-video-edit/blob/main/SKILL.md) (Claude Code skill), [`scripts/mix.py`](https://github.com/yildizdikme/claude-video-edit/blob/main/scripts/mix.py) (Final mix), [`scripts/_common.py`](https://github.com/yildizdikme/claude-video-edit/blob/main/scripts/_common.py) (Media helpers), [`scripts/render.mjs`](https://github.com/yildizdikme/claude-video-edit/blob/main/scripts/render.mjs) (Frame renderer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Editing workflow"]
  node_claude["Claude Code skill<br/>[SKILL.md]"]
end

subgraph group_media["Media processing"]
  node_transcribe["Transcription<br/>[transcribe.py]"]
  node_cuts["Word-aware cuts<br/>[cuts.py]"]
  node_build["Program build<br/>[build.py]"]
  node_effects["Effect synthesis<br/>[sfx.py]"]
  node_mix["Final mix<br/>[mix.py]"]
  node_common["Media helpers<br/>[_common.py]"]
end

subgraph group_graphics["Graphics and render"]
  node_scene["Scene template<br/>[engine.js]"]
  node_serve["Preview server<br/>[serve.py]"]
  node_render["Frame renderer<br/>[render.mjs]"]
  node_audit["Layout audit<br/>[audit.mjs]"]
end

subgraph group_support["Profile and checks"]
  node_verify["Cut verification<br/>[verify.py]"]
  node_loudness["Loudness report<br/>[loudness.py]"]
  node_profile["Creator profile<br/>[profile.md]"]
end

node_creator(("Creator"))
node_chrome["Headless Chrome"]

node_creator -->|"requests edit"| node_claude
node_claude -->|"transcribes clips"| node_transcribe
node_claude -->|"prepares rough cut"| node_cuts
node_claude -->|"shares preview"| node_creator
node_creator -->|"gives notes"| node_claude
node_claude -->|"proposes chapters"| node_creator
node_claude -->|"builds graphics"| node_scene
node_creator -->|"approves preview"| node_claude
node_claude -->|"renders scenes"| node_render
node_render -->|"drives browser"| node_chrome
node_scene -->|"provides frames"| node_render
node_claude -.->|"requests effects"| node_effects
node_render -->|"provides video cues"| node_mix
node_build -->|"provides voice audio"| node_mix
node_effects -->|"synthesizes effects"| node_mix
node_mix -->|"delivers final"| node_creator
node_cuts -->|"uses helpers"| node_common
node_transcribe -->|"uses helpers"| node_common
node_build -->|"uses helpers"| node_common
node_verify -->|"uses helpers"| node_common
node_verify -->|"uses cut logic"| node_cuts
node_verify -->|"uses transcription"| node_transcribe
node_mix -->|"uses helpers"| node_common
node_mix -->|"uses synthesizer"| node_effects
node_loudness -->|"measures audio"| node_common
node_audit -->|"drives browser"| node_chrome
node_creator -->|"sets preferences"| node_profile
node_claude -->|"remembers preferences"| node_profile

click node_claude "https://github.com/yildizdikme/claude-video-edit/blob/main/SKILL.md"
click node_transcribe "https://github.com/yildizdikme/claude-video-edit/blob/main/scripts/transcribe.py"
click node_cuts "https://github.com/yildizdikme/claude-video-edit/blob/main/scripts/cuts.py"
click node_build "https://github.com/yildizdikme/claude-video-edit/blob/main/scripts/build.py"
click node_verify "https://github.com/yildizdikme/claude-video-edit/blob/main/scripts/verify.py"
click node_effects "https://github.com/yildizdikme/claude-video-edit/blob/main/scripts/sfx.py"
click node_mix "https://github.com/yildizdikme/claude-video-edit/blob/main/scripts/mix.py"
click node_loudness "https://github.com/yildizdikme/claude-video-edit/blob/main/scripts/loudness.py"
click node_scene "https://github.com/yildizdikme/claude-video-edit/blob/main/template/engine.js"
click node_serve "https://github.com/yildizdikme/claude-video-edit/blob/main/scripts/serve.py"
click node_render "https://github.com/yildizdikme/claude-video-edit/blob/main/scripts/render.mjs"
click node_audit "https://github.com/yildizdikme/claude-video-edit/blob/main/scripts/audit.mjs"
click node_profile "https://github.com/yildizdikme/claude-video-edit/blob/main/reference/profile.md"
click node_common "https://github.com/yildizdikme/claude-video-edit/blob/main/scripts/_common.py"

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_claude toneBlue
class node_transcribe,node_cuts,node_build,node_effects,node_mix,node_common toneAmber
class node_scene,node_serve,node_render,node_audit toneMint
class node_verify,node_loudness,node_profile toneRose
class node_creator,node_chrome toneIndigo
```

## Components

### Editing workflow

- [Claude Code skill](https://github.com/yildizdikme/claude-video-edit/blob/main/SKILL.md): `SKILL.md`

### Media processing

- [Transcription](https://github.com/yildizdikme/claude-video-edit/blob/main/scripts/transcribe.py): `scripts/transcribe.py`
- [Word-aware cuts](https://github.com/yildizdikme/claude-video-edit/blob/main/scripts/cuts.py): `scripts/cuts.py`
- [Program build](https://github.com/yildizdikme/claude-video-edit/blob/main/scripts/build.py): `scripts/build.py`
- [Effect synthesis](https://github.com/yildizdikme/claude-video-edit/blob/main/scripts/sfx.py): `scripts/sfx.py`
- [Final mix](https://github.com/yildizdikme/claude-video-edit/blob/main/scripts/mix.py): `scripts/mix.py`
- [Media helpers](https://github.com/yildizdikme/claude-video-edit/blob/main/scripts/_common.py): `scripts/_common.py`

### Graphics and render

- [Scene template](https://github.com/yildizdikme/claude-video-edit/blob/main/template/engine.js): `template/engine.js`
- [Preview server](https://github.com/yildizdikme/claude-video-edit/blob/main/scripts/serve.py): `scripts/serve.py`
- [Frame renderer](https://github.com/yildizdikme/claude-video-edit/blob/main/scripts/render.mjs): `scripts/render.mjs`
- [Layout audit](https://github.com/yildizdikme/claude-video-edit/blob/main/scripts/audit.mjs): `scripts/audit.mjs`

### Profile and checks

- [Cut verification](https://github.com/yildizdikme/claude-video-edit/blob/main/scripts/verify.py): `scripts/verify.py`
- [Loudness report](https://github.com/yildizdikme/claude-video-edit/blob/main/scripts/loudness.py): `scripts/loudness.py`
- [Creator profile](https://github.com/yildizdikme/claude-video-edit/blob/main/reference/profile.md): `reference/profile.md`

### Other components

- **Creator**
- **Headless Chrome**

## Connections

- Creator → Claude Code skill: requests edit (evidence: `README.md`)
- Claude Code skill → Transcription: transcribes clips (evidence: `README.md`)
- Claude Code skill → Word-aware cuts: prepares rough cut (evidence: `README.md`)
- Claude Code skill → Creator: shares preview (evidence: `README.md`)
- Creator → Claude Code skill: gives notes (evidence: `README.md`)
- Claude Code skill → Creator: proposes chapters (evidence: `README.md`)
- Claude Code skill → Scene template: builds graphics (evidence: `README.md`)
- Creator → Claude Code skill: approves preview (evidence: `README.md`)
- Claude Code skill → Frame renderer: renders scenes (evidence: `README.md`)
- Frame renderer → Headless Chrome: drives browser (evidence: `scripts/render.mjs`)
- Scene template → Frame renderer: provides frames (evidence: `scripts/render.mjs`)
- Claude Code skill → Effect synthesis: requests effects (evidence: `README.md`)
- Frame renderer → Final mix: provides video cues (evidence: `scripts/mix.py`)
- Program build → Final mix: provides voice audio (evidence: `scripts/mix.py`)
- Effect synthesis → Final mix: synthesizes effects (evidence: `scripts/mix.py`)
- Final mix → Creator: delivers final (evidence: `README.md`)
- Word-aware cuts → Media helpers: uses helpers (evidence: `scripts/cuts.py`)
- Transcription → Media helpers: uses helpers (evidence: `scripts/transcribe.py`)
- Program build → Media helpers: uses helpers (evidence: `scripts/build.py`)
- Cut verification → Media helpers: uses helpers (evidence: `scripts/verify.py`)
- Cut verification → Word-aware cuts: uses cut logic (evidence: `scripts/verify.py`)
- Cut verification → Transcription: uses transcription (evidence: `scripts/verify.py`)
- Final mix → Media helpers: uses helpers (evidence: `scripts/mix.py`)
- Final mix → Effect synthesis: uses synthesizer (evidence: `scripts/mix.py`)
- Loudness report → Media helpers: measures audio (evidence: `scripts/loudness.py`)
- Layout audit → Headless Chrome: drives browser (evidence: `scripts/audit.mjs`)
- Creator → Creator profile: sets preferences (evidence: `README.md`)
- Claude Code skill → Creator profile: remembers preferences (evidence: `README.md`)
