# haidrrrry/claude-remotion-skill architecture

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

- Interactive diagram: https://gitdiagram.com/haidrrrry/claude-remotion-skill
- Repository: https://github.com/haidrrrry/claude-remotion-skill

## Overview

This repository is a Claude agent skill for creating and refining Remotion motion-graphics videos. The main workflow is a user prompt, Claude reading the skill and applying its motion/design guidance, then rendering with Remotion and using ffmpeg to extract frames for inspection and revision before delivery. The repository also includes four example compositions. Relationships below are based on README statements; source excerpts were not provided, so implementation-level calls are not asserted.

Main entry points: [`remotion-motion-graphics/SKILL.md`](https://github.com/haidrrrry/claude-remotion-skill/blob/main/remotion-motion-graphics/SKILL.md) (Workflow and rules), [`remotion-motion-graphics/references/motion-patterns.md`](https://github.com/haidrrrry/claude-remotion-skill/blob/main/remotion-motion-graphics/references/motion-patterns.md) (Motion patterns), [`remotion-motion-graphics/references/design-rules.md`](https://github.com/haidrrrry/claude-remotion-skill/blob/main/remotion-motion-graphics/references/design-rules.md) (Design rules), [`remotion-motion-graphics/assets/theme.ts`](https://github.com/haidrrrry/claude-remotion-skill/blob/main/remotion-motion-graphics/assets/theme.ts) (Theme template)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guidance["Skill guidance"]
  node_skill["Workflow and rules<br/>[SKILL.md]"]
  node_patterns["Motion patterns<br/>[motion-patterns.md]"]
  node_design["Design rules<br/>[design-rules.md]"]
  node_theme["Theme template<br/>[theme.ts]"]
end

subgraph group_examples["Example compositions"]
  node_profile["Profile promo<br/>[Bio.tsx]"]
  node_focuscat["Focus Cat promo<br/>[FocusCat.tsx]"]
  node_selffix["Self-fix demo<br/>[SelfFix.tsx]"]
  node_codeedit["Beat-synced edit<br/>[CodeEdit.tsx]"]
end

subgraph group_rendering["Video workflow"]
  node_remotion["Remotion renderer"]
  node_ffmpeg["ffmpeg"]
  node_frames["Extracted frames"]
  node_finished["Verified video"]
end

node_user(("Video requester"))
node_claude(("Claude agent"))

node_user -->|"requests video"| node_claude
node_claude -->|"reads workflow"| node_skill
node_claude -->|"applies patterns"| node_patterns
node_claude -->|"applies guidance"| node_design
node_claude -->|"uses theme"| node_theme
node_claude -->|"renders video"| node_remotion
node_claude -->|"extracts frames"| node_ffmpeg
node_ffmpeg -->|"produces frames"| node_frames
node_claude -->|"inspects frames"| node_frames
node_claude -->|"rerenders fixes"| node_remotion
node_claude -->|"delivers verified"| node_finished
node_skill -->|"guides example"| node_profile
node_skill -->|"guides example"| node_focuscat
node_skill -->|"guides example"| node_selffix
node_skill -->|"guides example"| node_codeedit

click node_skill "https://github.com/haidrrrry/claude-remotion-skill/blob/main/remotion-motion-graphics/SKILL.md"
click node_patterns "https://github.com/haidrrrry/claude-remotion-skill/blob/main/remotion-motion-graphics/references/motion-patterns.md"
click node_design "https://github.com/haidrrrry/claude-remotion-skill/blob/main/remotion-motion-graphics/references/design-rules.md"
click node_theme "https://github.com/haidrrrry/claude-remotion-skill/blob/main/remotion-motion-graphics/assets/theme.ts"
click node_profile "https://github.com/haidrrrry/claude-remotion-skill/blob/main/examples/src/scenes/Bio.tsx"
click node_focuscat "https://github.com/haidrrrry/claude-remotion-skill/blob/main/examples/src/focuscat/FocusCat.tsx"
click node_selffix "https://github.com/haidrrrry/claude-remotion-skill/blob/main/examples/src/selffix/SelfFix.tsx"
click node_codeedit "https://github.com/haidrrrry/claude-remotion-skill/blob/main/examples/src/codeedit/CodeEdit.tsx"

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_patterns,node_design,node_theme toneBlue
class node_profile,node_focuscat,node_selffix,node_codeedit toneAmber
class node_remotion,node_ffmpeg,node_frames,node_finished,node_user toneMint
class node_claude toneIndigo
```

## Components

### Skill guidance

- [Workflow and rules](https://github.com/haidrrrry/claude-remotion-skill/blob/main/remotion-motion-graphics/SKILL.md): `remotion-motion-graphics/SKILL.md`
- [Motion patterns](https://github.com/haidrrrry/claude-remotion-skill/blob/main/remotion-motion-graphics/references/motion-patterns.md): `remotion-motion-graphics/references/motion-patterns.md`
- [Design rules](https://github.com/haidrrrry/claude-remotion-skill/blob/main/remotion-motion-graphics/references/design-rules.md): `remotion-motion-graphics/references/design-rules.md`
- [Theme template](https://github.com/haidrrrry/claude-remotion-skill/blob/main/remotion-motion-graphics/assets/theme.ts): `remotion-motion-graphics/assets/theme.ts`

### Example compositions

- [Profile promo](https://github.com/haidrrrry/claude-remotion-skill/blob/main/examples/src/scenes/Bio.tsx): `examples/src/scenes/Bio.tsx`
- [Focus Cat promo](https://github.com/haidrrrry/claude-remotion-skill/blob/main/examples/src/focuscat/FocusCat.tsx): `examples/src/focuscat/FocusCat.tsx`
- [Self-fix demo](https://github.com/haidrrrry/claude-remotion-skill/blob/main/examples/src/selffix/SelfFix.tsx): `examples/src/selffix/SelfFix.tsx`
- [Beat-synced edit](https://github.com/haidrrrry/claude-remotion-skill/blob/main/examples/src/codeedit/CodeEdit.tsx): `examples/src/codeedit/CodeEdit.tsx`

### Video workflow

- **Remotion renderer**
- **ffmpeg**
- **Extracted frames**
- **Verified video**

### Other components

- **Video requester**
- **Claude agent**

## Connections

- Video requester → Claude agent: requests video (evidence: `README.md`)
- Claude agent → Workflow and rules: reads workflow (evidence: `README.md`)
- Claude agent → Motion patterns: applies patterns (evidence: `README.md`)
- Claude agent → Design rules: applies guidance (evidence: `README.md`)
- Claude agent → Theme template: uses theme (evidence: `README.md`)
- Claude agent → Remotion renderer: renders video (evidence: `README.md`)
- Claude agent → ffmpeg: extracts frames (evidence: `README.md`)
- ffmpeg → Extracted frames: produces frames (evidence: `README.md`)
- Claude agent → Extracted frames: inspects frames (evidence: `README.md`)
- Claude agent → Remotion renderer: rerenders fixes (evidence: `README.md`)
- Claude agent → Verified video: delivers verified (evidence: `README.md`)
- Workflow and rules → Profile promo: guides example (evidence: `README.md`)
- Workflow and rules → Focus Cat promo: guides example (evidence: `README.md`)
- Workflow and rules → Self-fix demo: guides example (evidence: `README.md`)
- Workflow and rules → Beat-synced edit: guides example (evidence: `README.md`)
