# cth9191/motion-design architecture

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

- Interactive diagram: https://gitdiagram.com/cth9191/motion-design
- Repository: https://github.com/cth9191/motion-design

## Overview

This repository packages a motion-design skill for Codex and Claude Code, plus a local style gallery. The main workflow is to choose a style, adapt its source prompt to a brief, review the full draft, then request generation and inspect the result. The README documents the workflow and gallery behavior; detailed runtime wiring is not sampled, so the graph avoids claiming unverified calls between skill references.

Main entry points: [`skills/motion-design/assets/gallery.html`](https://github.com/cth9191/motion-design/blob/main/skills/motion-design/assets/gallery.html) (Playable gallery), [`skills/motion-design/SKILL.md`](https://github.com/cth9191/motion-design/blob/main/skills/motion-design/SKILL.md) (Motion skill)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Creation workflow"]
  node_skill["Motion skill<br/>[SKILL.md]"]
  node_brief["Creative brief<br/>[creative-brief.md]"]
  node_adaptation["Prompt adaptation"]
  node_production["Production process<br/>[production.md]"]
  node_review["Quality review<br/>[quality-review.md]"]
end

subgraph group_library["Style library"]
  node_catalog[("Preset catalog<br/>[presets.json]")]
  node_preset_guides["Preset guides"]
  node_templates["Prompt templates"]
  node_source_prompts["Original prompts"]
  node_preset_index["Preset index<br/>[preset-index.md]"]
end

subgraph group_guidance["Production guidance"]
  node_tool_routing["Tool routing<br/>[tool-routing.md]"]
  node_video_reference["Video references<br/>[video-reference.md]"]
  node_preset_workflow["Preset workflow<br/>[preset-workflow.md]"]
end

subgraph group_gallery["Local gallery"]
  node_gallery["Playable gallery<br/>[gallery.html]"]
end

node_creator(("Creator"))
node_assistant["Codex or Claude"]
node_higgsfield["Higgsfield"]
node_film["Generated film"]

node_creator -->|"requests film"| node_assistant
node_assistant -->|"invokes"| node_skill
node_creator -->|"browses styles"| node_gallery
node_gallery -->|"copies request"| node_creator
node_creator -->|"submits brief"| node_assistant
node_assistant -->|"adapts prompt"| node_skill
node_assistant -->|"shows draft"| node_creator
node_creator -->|"approves generation"| node_assistant
node_assistant -->|"requests generation"| node_higgsfield
node_higgsfield -->|"returns film"| node_film
node_assistant -->|"presents result"| node_creator

click node_skill "https://github.com/cth9191/motion-design/blob/main/skills/motion-design/SKILL.md"
click node_brief "https://github.com/cth9191/motion-design/blob/main/skills/motion-design/references/creative-brief.md"
click node_adaptation "https://github.com/cth9191/motion-design/blob/main/skills/motion-design/references/template-adaptation.md"
click node_production "https://github.com/cth9191/motion-design/blob/main/skills/motion-design/references/production.md"
click node_review "https://github.com/cth9191/motion-design/blob/main/skills/motion-design/references/quality-review.md"
click node_catalog "https://github.com/cth9191/motion-design/blob/main/skills/motion-design/assets/presets.json"
click node_preset_guides "https://github.com/cth9191/motion-design/tree/main/skills/motion-design/references/presets"
click node_templates "https://github.com/cth9191/motion-design/tree/main/skills/motion-design/references/templates"
click node_source_prompts "https://github.com/cth9191/motion-design/tree/main/skills/motion-design/references/source-prompts"
click node_preset_index "https://github.com/cth9191/motion-design/blob/main/skills/motion-design/references/preset-index.md"
click node_tool_routing "https://github.com/cth9191/motion-design/blob/main/skills/motion-design/references/tool-routing.md"
click node_video_reference "https://github.com/cth9191/motion-design/blob/main/skills/motion-design/references/video-reference.md"
click node_preset_workflow "https://github.com/cth9191/motion-design/blob/main/skills/motion-design/references/preset-workflow.md"
click node_gallery "https://github.com/cth9191/motion-design/blob/main/skills/motion-design/assets/gallery.html"

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_brief,node_adaptation,node_production,node_review toneBlue
class node_catalog,node_preset_guides,node_templates,node_source_prompts,node_preset_index toneAmber
class node_tool_routing,node_video_reference,node_preset_workflow toneMint
class node_gallery toneRose
class node_creator,node_assistant,node_higgsfield,node_film toneIndigo
```

## Components

### Creation workflow

- [Motion skill](https://github.com/cth9191/motion-design/blob/main/skills/motion-design/SKILL.md): `skills/motion-design/SKILL.md`
- [Creative brief](https://github.com/cth9191/motion-design/blob/main/skills/motion-design/references/creative-brief.md): `skills/motion-design/references/creative-brief.md`
- [Prompt adaptation](https://github.com/cth9191/motion-design/blob/main/skills/motion-design/references/template-adaptation.md): `skills/motion-design/references/template-adaptation.md`
- [Production process](https://github.com/cth9191/motion-design/blob/main/skills/motion-design/references/production.md): `skills/motion-design/references/production.md`
- [Quality review](https://github.com/cth9191/motion-design/blob/main/skills/motion-design/references/quality-review.md): `skills/motion-design/references/quality-review.md`

### Style library

- [Preset catalog](https://github.com/cth9191/motion-design/blob/main/skills/motion-design/assets/presets.json): `skills/motion-design/assets/presets.json`
- [Preset guides](https://github.com/cth9191/motion-design/tree/main/skills/motion-design/references/presets): `skills/motion-design/references/presets`
- [Prompt templates](https://github.com/cth9191/motion-design/tree/main/skills/motion-design/references/templates): `skills/motion-design/references/templates`
- [Original prompts](https://github.com/cth9191/motion-design/tree/main/skills/motion-design/references/source-prompts): `skills/motion-design/references/source-prompts`
- [Preset index](https://github.com/cth9191/motion-design/blob/main/skills/motion-design/references/preset-index.md): `skills/motion-design/references/preset-index.md`

### Production guidance

- [Tool routing](https://github.com/cth9191/motion-design/blob/main/skills/motion-design/references/tool-routing.md): `skills/motion-design/references/tool-routing.md`
- [Video references](https://github.com/cth9191/motion-design/blob/main/skills/motion-design/references/video-reference.md): `skills/motion-design/references/video-reference.md`
- [Preset workflow](https://github.com/cth9191/motion-design/blob/main/skills/motion-design/references/preset-workflow.md): `skills/motion-design/references/preset-workflow.md`

### Local gallery

- [Playable gallery](https://github.com/cth9191/motion-design/blob/main/skills/motion-design/assets/gallery.html): `skills/motion-design/assets/gallery.html`

### Other components

- **Creator**
- **Codex or Claude**
- **Higgsfield**
- **Generated film**

## Connections

- Creator → Codex or Claude: requests film (evidence: `README.md`)
- Codex or Claude → Motion skill: invokes (evidence: `README.md`)
- Creator → Playable gallery: browses styles (evidence: `README.md`)
- Playable gallery → Creator: copies request (evidence: `README.md`)
- Creator → Codex or Claude: submits brief (evidence: `README.md`)
- Codex or Claude → Motion skill: adapts prompt (evidence: `README.md`)
- Codex or Claude → Creator: shows draft (evidence: `README.md`)
- Creator → Codex or Claude: approves generation (evidence: `README.md`)
- Codex or Claude → Higgsfield: requests generation (evidence: `README.md`)
- Higgsfield → Generated film: returns film (evidence: `README.md`)
- Codex or Claude → Creator: presents result (evidence: `README.md`)