# abhimahamkali/claude-motion-skill architecture

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

- Interactive diagram: https://gitdiagram.com/abhimahamkali/claude-motion-skill
- Repository: https://github.com/abhimahamkali/claude-motion-skill

## Overview

This repository packages a Claude Code motion-graphics skill and a Node renderer. The user describes an idea; Claude develops a visual analogy, authors a canvas scene, reviews stills, renders an MP4, and iterates from feedback. The README also documents format changes and share-copy/contact-sheet outputs. Renderer relationships are grounded in its source; the skill workflow and visual guidance are documented in the README, but their unsampled implementation details are not inferred.

Main entry points: [`plugins/motion/skills/motion/engine/render.mjs`](https://github.com/abhimahamkali/claude-motion-skill/blob/main/plugins/motion/skills/motion/engine/render.mjs) (Render engine), [`plugins/motion/skills/motion/SKILL.md`](https://github.com/abhimahamkali/claude-motion-skill/blob/main/plugins/motion/skills/motion/SKILL.md) (Motion skill), [`plugins/motion/skills/motion/engine/template.html`](https://github.com/abhimahamkali/claude-motion-skill/blob/main/plugins/motion/skills/motion/engine/template.html) (Canvas scene), [`plugins/motion/skills/motion/references/style.md`](https://github.com/abhimahamkali/claude-motion-skill/blob/main/plugins/motion/skills/motion/references/style.md) (Visual guidance)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_creation["Creative workflow"]
  node_skill["Motion skill<br/>[SKILL.md]"]
  node_scene["Canvas scene<br/>[template.html]"]
  node_review["Still review<br/>[SKILL.md]"]
end

subgraph group_rendering["Rendering"]
  node_renderer["Render engine<br/>[render.mjs]"]
  node_artifacts["Video and review files<br/>[render.mjs]"]
end

subgraph group_guidance["Creative resources"]
  node_style["Visual guidance<br/>[style.md]"]
  node_example["Approved example"]
end

node_user(("User"))
node_claude(("Claude Code"))
node_chrome["Headless Chrome"]
node_ffmpeg["ffmpeg"]

node_user -->|"submits brief"| node_claude
node_claude -->|"follows workflow"| node_skill
node_skill -->|"authors scene"| node_scene
node_skill -->|"reviews stills"| node_review
node_skill -->|"uses guidance"| node_style
node_skill -.->|"can reference"| node_example
node_claude -->|"runs renderer"| node_renderer
node_renderer -->|"opens page"| node_scene
node_renderer -->|"launches"| node_chrome
node_chrome -->|"posts frames"| node_renderer
node_renderer -->|"pipes frames"| node_ffmpeg
node_renderer -->|"writes outputs"| node_artifacts
node_user -->|"gives feedback"| node_claude

click node_skill "https://github.com/abhimahamkali/claude-motion-skill/blob/main/plugins/motion/skills/motion/SKILL.md"
click node_scene "https://github.com/abhimahamkali/claude-motion-skill/blob/main/plugins/motion/skills/motion/engine/template.html"
click node_review "https://github.com/abhimahamkali/claude-motion-skill/blob/main/plugins/motion/skills/motion/SKILL.md"
click node_style "https://github.com/abhimahamkali/claude-motion-skill/blob/main/plugins/motion/skills/motion/references/style.md"
click node_example "https://github.com/abhimahamkali/claude-motion-skill/blob/main/plugins/motion/skills/motion/examples/watermelon-to-pomegranate.html"
click node_renderer "https://github.com/abhimahamkali/claude-motion-skill/blob/main/plugins/motion/skills/motion/engine/render.mjs"
click node_artifacts "https://github.com/abhimahamkali/claude-motion-skill/blob/main/plugins/motion/skills/motion/engine/render.mjs"

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_scene,node_review,node_user toneBlue
class node_renderer,node_artifacts toneAmber
class node_style,node_example toneMint
class node_claude,node_chrome,node_ffmpeg toneIndigo
```

## Components

### Creative workflow

- [Motion skill](https://github.com/abhimahamkali/claude-motion-skill/blob/main/plugins/motion/skills/motion/SKILL.md): `plugins/motion/skills/motion/SKILL.md`
- [Canvas scene](https://github.com/abhimahamkali/claude-motion-skill/blob/main/plugins/motion/skills/motion/engine/template.html): `plugins/motion/skills/motion/engine/template.html`
- [Still review](https://github.com/abhimahamkali/claude-motion-skill/blob/main/plugins/motion/skills/motion/SKILL.md): `plugins/motion/skills/motion/SKILL.md`

### Rendering

- [Render engine](https://github.com/abhimahamkali/claude-motion-skill/blob/main/plugins/motion/skills/motion/engine/render.mjs): `plugins/motion/skills/motion/engine/render.mjs`
- [Video and review files](https://github.com/abhimahamkali/claude-motion-skill/blob/main/plugins/motion/skills/motion/engine/render.mjs): `plugins/motion/skills/motion/engine/render.mjs`

### Creative resources

- [Visual guidance](https://github.com/abhimahamkali/claude-motion-skill/blob/main/plugins/motion/skills/motion/references/style.md): `plugins/motion/skills/motion/references/style.md`
- [Approved example](https://github.com/abhimahamkali/claude-motion-skill/blob/main/plugins/motion/skills/motion/examples/watermelon-to-pomegranate.html): `plugins/motion/skills/motion/examples/watermelon-to-pomegranate.html`

### Other components

- **User**
- **Claude Code**
- **Headless Chrome**
- **ffmpeg**

## Connections

- User → Claude Code: submits brief (evidence: `README.md`)
- Claude Code → Motion skill: follows workflow (evidence: `README.md`)
- Motion skill → Canvas scene: authors scene (evidence: `README.md`)
- Motion skill → Still review: reviews stills (evidence: `README.md`)
- Motion skill → Visual guidance: uses guidance (evidence: `README.md`)
- Motion skill → Approved example: can reference
- Claude Code → Render engine: runs renderer (evidence: `README.md`)
- Render engine → Canvas scene: opens page (evidence: `plugins/motion/skills/motion/engine/render.mjs`)
- Render engine → Headless Chrome: launches (evidence: `plugins/motion/skills/motion/engine/render.mjs`)
- Headless Chrome → Render engine: posts frames (evidence: `plugins/motion/skills/motion/engine/render.mjs`)
- Render engine → ffmpeg: pipes frames (evidence: `plugins/motion/skills/motion/engine/render.mjs`)
- Render engine → Video and review files: writes outputs (evidence: `plugins/motion/skills/motion/engine/render.mjs`)
- User → Claude Code: gives feedback (evidence: `README.md`)
