# artemnovitckii/claude-editing-skills architecture

> Architecture diagram of the GitHub repository artemnovitckii/claude-editing-skills, 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/artemnovitckii/claude-editing-skills
- Repository: https://github.com/artemnovitckii/claude-editing-skills

## Overview

Claude Code editing skills turn a user’s clip and a skill-specific JSON spec into locally rendered short-form video. In the original six workflows, the skill’s instructions guide spec creation; shared reel code prepares the clip, loads word timings, builds and renders a composition, and produces a safe-zone contact sheet. Five photographic styles instead prepare editable HTML templates and media. The graph preserves both branches and the documented transcription, speaker-cutout, and visual-style capabilities. Some skill implementations were not sampled; their README-documented capabilities are shown without inferring internal calls.

Main entry points: [`kit/reel.py`](https://github.com/artemnovitckii/claude-editing-skills/blob/main/kit/reel.py) (Clip composition), [`skills`](https://github.com/artemnovitckii/claude-editing-skills/tree/main/skills) (Skill instructions), [`kit/style_template.py`](https://github.com/artemnovitckii/claude-editing-skills/blob/main/kit/style_template.py) (Template preparation), [`skills/behind-the-person/build.py`](https://github.com/artemnovitckii/claude-editing-skills/blob/main/skills/behind-the-person/build.py) (Behind person)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_skills["Editing skills"]
  node_instructions["Skill instructions"]
  node_trial["Trial reels<br/>[build.py]"]
  node_behind["Behind person<br/>[build.py]"]
  node_explainer["Explainer<br/>[build.py]"]
  node_split["Split screen<br/>[build.py]"]
  node_ranking["Ranking list<br/>[build.py]"]
  node_storytelling["Storytelling<br/>[build.py]"]
  node_cutout_skill["Speaker cutout"]
end

subgraph group_shared["Shared media kit"]
  node_reel["Clip composition<br/>[reel.py]"]
  node_transcribe["Word transcription<br/>[transcribe.py]"]
  node_matting["Video matting<br/>[cutout.py]"]
  node_template["Template preparation<br/>[style_template.py]"]
end

subgraph group_styles["Photographic styles"]
  node_style_skills["Photo styles"]
  node_orbit["Orbit reel<br/>[build.py]"]
  node_picture["Picture stack<br/>[build.py]"]
  node_scene["Scene switch<br/>[build.py]"]
  node_shape["Shape shift<br/>[build.py]"]
  node_notes["Visual notes<br/>[build.py]"]
end

subgraph group_services["External services"]
  node_groq["Groq Whisper"]
  node_hyperframes["HyperFrames"]
end

node_creator(("Clip creator"))
node_video["Rendered video"]
node_contact["Contact sheet"]

node_creator -->|"chooses workflow"| node_instructions
node_creator -->|"invokes skill"| node_trial
node_creator -->|"invokes skill"| node_behind
node_creator -->|"invokes skill"| node_explainer
node_creator -->|"invokes skill"| node_split
node_creator -->|"invokes skill"| node_ranking
node_creator -->|"invokes skill"| node_storytelling
node_creator -->|"invokes style"| node_orbit
node_creator -->|"invokes style"| node_picture
node_creator -->|"invokes style"| node_scene
node_creator -->|"invokes style"| node_shape
node_creator -->|"invokes style"| node_notes
node_instructions -->|"guides spec"| node_trial
node_instructions -->|"guides spec"| node_behind
node_instructions -->|"guides spec"| node_explainer
node_instructions -->|"guides spec"| node_split
node_instructions -->|"guides spec"| node_ranking
node_instructions -->|"guides spec"| node_storytelling
node_instructions -->|"guides customization"| node_style_skills
node_trial -->|"uses shared kit"| node_reel
node_behind -->|"uses shared kit"| node_reel
node_explainer -->|"uses shared kit"| node_reel
node_split -->|"uses shared kit"| node_reel
node_ranking -->|"uses shared kit"| node_reel
node_storytelling -->|"uses shared kit"| node_reel
node_reel -->|"loads word timings"| node_transcribe
node_transcribe -->|"requests transcription"| node_groq
node_reel -->|"creates speaker cutout"| node_matting
node_behind -->|"adds graphics behind speaker"| node_cutout_skill
node_cutout_skill -->|"uses matting"| node_matting
node_reel -->|"renders composition"| node_hyperframes
node_reel -->|"produces video"| node_video
node_reel -->|"generates sheet"| node_contact
node_orbit -->|"delegates to"| node_template
node_picture -->|"delegates to"| node_template
node_scene -->|"delegates to"| node_template
node_shape -->|"delegates to"| node_template
node_notes -->|"delegates to"| node_template
node_template -->|"renders template"| node_hyperframes
node_template -->|"produces video"| node_video

click node_instructions "https://github.com/artemnovitckii/claude-editing-skills/tree/main/skills"
click node_trial "https://github.com/artemnovitckii/claude-editing-skills/blob/main/skills/trial-reels/build.py"
click node_behind "https://github.com/artemnovitckii/claude-editing-skills/blob/main/skills/behind-the-person/build.py"
click node_explainer "https://github.com/artemnovitckii/claude-editing-skills/blob/main/skills/explainer/build.py"
click node_split "https://github.com/artemnovitckii/claude-editing-skills/blob/main/skills/split-screen/build.py"
click node_ranking "https://github.com/artemnovitckii/claude-editing-skills/blob/main/skills/ranking-list/build.py"
click node_storytelling "https://github.com/artemnovitckii/claude-editing-skills/blob/main/skills/storytelling/build.py"
click node_cutout_skill "https://github.com/artemnovitckii/claude-editing-skills/tree/main/skills/behind-the-person"
click node_style_skills "https://github.com/artemnovitckii/claude-editing-skills/tree/main/skills"
click node_orbit "https://github.com/artemnovitckii/claude-editing-skills/blob/main/skills/orbit-reel/build.py"
click node_picture "https://github.com/artemnovitckii/claude-editing-skills/blob/main/skills/picture-stack/build.py"
click node_scene "https://github.com/artemnovitckii/claude-editing-skills/blob/main/skills/scene-switch/build.py"
click node_shape "https://github.com/artemnovitckii/claude-editing-skills/blob/main/skills/shape-shift/build.py"
click node_notes "https://github.com/artemnovitckii/claude-editing-skills/blob/main/skills/visual-notes/build.py"
click node_reel "https://github.com/artemnovitckii/claude-editing-skills/blob/main/kit/reel.py"
click node_transcribe "https://github.com/artemnovitckii/claude-editing-skills/blob/main/kit/transcribe.py"
click node_matting "https://github.com/artemnovitckii/claude-editing-skills/blob/main/kit/cutout.py"
click node_template "https://github.com/artemnovitckii/claude-editing-skills/blob/main/kit/style_template.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_instructions,node_trial,node_behind,node_explainer,node_split,node_ranking,node_storytelling,node_cutout_skill toneBlue
class node_reel,node_transcribe,node_matting,node_template toneAmber
class node_style_skills,node_orbit,node_picture,node_scene,node_shape,node_notes toneMint
class node_groq,node_hyperframes toneRose
class node_creator,node_video,node_contact toneIndigo
```

## Components

### Editing skills

- [Skill instructions](https://github.com/artemnovitckii/claude-editing-skills/tree/main/skills): `skills`
- [Trial reels](https://github.com/artemnovitckii/claude-editing-skills/blob/main/skills/trial-reels/build.py): `skills/trial-reels/build.py`
- [Behind person](https://github.com/artemnovitckii/claude-editing-skills/blob/main/skills/behind-the-person/build.py): `skills/behind-the-person/build.py`
- [Explainer](https://github.com/artemnovitckii/claude-editing-skills/blob/main/skills/explainer/build.py): `skills/explainer/build.py`
- [Split screen](https://github.com/artemnovitckii/claude-editing-skills/blob/main/skills/split-screen/build.py): `skills/split-screen/build.py`
- [Ranking list](https://github.com/artemnovitckii/claude-editing-skills/blob/main/skills/ranking-list/build.py): `skills/ranking-list/build.py`
- [Storytelling](https://github.com/artemnovitckii/claude-editing-skills/blob/main/skills/storytelling/build.py): `skills/storytelling/build.py`
- [Speaker cutout](https://github.com/artemnovitckii/claude-editing-skills/tree/main/skills/behind-the-person): `skills/behind-the-person`

### Shared media kit

- [Clip composition](https://github.com/artemnovitckii/claude-editing-skills/blob/main/kit/reel.py): `kit/reel.py`
- [Word transcription](https://github.com/artemnovitckii/claude-editing-skills/blob/main/kit/transcribe.py): `kit/transcribe.py`
- [Video matting](https://github.com/artemnovitckii/claude-editing-skills/blob/main/kit/cutout.py): `kit/cutout.py`
- [Template preparation](https://github.com/artemnovitckii/claude-editing-skills/blob/main/kit/style_template.py): `kit/style_template.py`

### Photographic styles

- [Photo styles](https://github.com/artemnovitckii/claude-editing-skills/tree/main/skills): `skills`
- [Orbit reel](https://github.com/artemnovitckii/claude-editing-skills/blob/main/skills/orbit-reel/build.py): `skills/orbit-reel/build.py`
- [Picture stack](https://github.com/artemnovitckii/claude-editing-skills/blob/main/skills/picture-stack/build.py): `skills/picture-stack/build.py`
- [Scene switch](https://github.com/artemnovitckii/claude-editing-skills/blob/main/skills/scene-switch/build.py): `skills/scene-switch/build.py`
- [Shape shift](https://github.com/artemnovitckii/claude-editing-skills/blob/main/skills/shape-shift/build.py): `skills/shape-shift/build.py`
- [Visual notes](https://github.com/artemnovitckii/claude-editing-skills/blob/main/skills/visual-notes/build.py): `skills/visual-notes/build.py`

### External services

- **Groq Whisper**
- **HyperFrames**

### Other components

- **Clip creator**
- **Rendered video**
- **Contact sheet**

## Connections

- Clip creator → Skill instructions: chooses workflow (evidence: `README.md`)
- Clip creator → Trial reels: invokes skill (evidence: `README.md`)
- Clip creator → Behind person: invokes skill (evidence: `README.md`)
- Clip creator → Explainer: invokes skill (evidence: `README.md`)
- Clip creator → Split screen: invokes skill (evidence: `README.md`)
- Clip creator → Ranking list: invokes skill (evidence: `README.md`)
- Clip creator → Storytelling: invokes skill (evidence: `README.md`)
- Clip creator → Orbit reel: invokes style (evidence: `README.md`)
- Clip creator → Picture stack: invokes style (evidence: `README.md`)
- Clip creator → Scene switch: invokes style (evidence: `README.md`)
- Clip creator → Shape shift: invokes style (evidence: `README.md`)
- Clip creator → Visual notes: invokes style (evidence: `README.md`)
- Skill instructions → Trial reels: guides spec (evidence: `README.md`)
- Skill instructions → Behind person: guides spec (evidence: `README.md`)
- Skill instructions → Explainer: guides spec (evidence: `README.md`)
- Skill instructions → Split screen: guides spec (evidence: `README.md`)
- Skill instructions → Ranking list: guides spec (evidence: `README.md`)
- Skill instructions → Storytelling: guides spec (evidence: `README.md`)
- Skill instructions → Photo styles: guides customization (evidence: `README.md`)
- Trial reels → Clip composition: uses shared kit (evidence: `skills/trial-reels/build.py`)
- Behind person → Clip composition: uses shared kit (evidence: `skills/behind-the-person/build.py`)
- Explainer → Clip composition: uses shared kit (evidence: `skills/explainer/build.py`)
- Split screen → Clip composition: uses shared kit (evidence: `skills/split-screen/build.py`)
- Ranking list → Clip composition: uses shared kit (evidence: `skills/ranking-list/build.py`)
- Storytelling → Clip composition: uses shared kit (evidence: `skills/storytelling/build.py`)
- Clip composition → Word transcription: loads word timings (evidence: `kit/reel.py`)
- Word transcription → Groq Whisper: requests transcription (evidence: `kit/transcribe.py`)
- Clip composition → Video matting: creates speaker cutout (evidence: `kit/reel.py`)
- Behind person → Speaker cutout: adds graphics behind speaker (evidence: `README.md`)
- Speaker cutout → Video matting: uses matting (evidence: `kit/cutout.py`)
- Clip composition → HyperFrames: renders composition (evidence: `kit/reel.py`)
- Clip composition → Rendered video: produces video (evidence: `kit/reel.py`)
- Clip composition → Contact sheet: generates sheet (evidence: `kit/reel.py`)
- Orbit reel → Template preparation: delegates to (evidence: `skills/orbit-reel/build.py`)
- Picture stack → Template preparation: delegates to (evidence: `skills/picture-stack/build.py`)
- Scene switch → Template preparation: delegates to (evidence: `README.md`)
- Shape shift → Template preparation: delegates to (evidence: `README.md`)
- Visual notes → Template preparation: delegates to (evidence: `README.md`)
- Template preparation → HyperFrames: renders template (evidence: `kit/style_template.py`)
- Template preparation → Rendered video: produces video (evidence: `kit/style_template.py`)
