Skip to main content
skill CX Codex

kinetograph — Claude Code skill: what it does, how to install

kinetograph is a Claude Code skill that routes video and motion-graphics work to the right next skill for building, checking, or rendering.

Apache-2.0 ★ 542 updated 2026-11-17

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add 0xS4N4TG/kinetograph --skill kinetograph -a claude-code
Open on GitHub

What kinetograph does

kinetograph handles requests to create, edit, preview, and render videos, animations, title cards, and sound design. It points the agent to the matching kinetograph-* skill: kinetograph-create starts a project, kinetograph-markup changes the composition, and kinetograph-render checks frames and exports the result.

Commands run through npx kinetograph <command>. Projects use TypeScript with the Remotion API, native elements, or HTML with GSAP; Node runs the process and a GPU compositor draws the output. The render workflow includes still frames, strips, scene inspection, linting, and export. Kinetograph has no browser for watching the video, so the result is examined through frames and the scene graph.

Through MCP, kinetograph mcp exposes one tool per command, with audio analyze mapped to audio_analyze. When the CLI or skills report that they are out of date, updating requires approval and then uses kinetograph-upgrade.

What it helps with

  • start a video or motion-graphics project
  • route composition changes to the right skill
  • inspect frames and the scene graph
  • render a video to a file
  • run Kinetograph commands through MCP

Example prompts for the agent

  • Create a Kinetograph project for a short animation.
  • Change the composition by adding a title card and sound design.
  • Inspect the frames, run linting, and render the video to a file.

How to install kinetograph

1Skills CLI (Vercel)

npx skills add 0xS4N4TG/kinetograph --skill kinetograph -a claude-code

2Manually: put the files in place

~/.claude/skills/kinetograph/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/kinetograph/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about kinetograph

How do I install kinetograph in Claude Code?

Run npx skills add 0xS4N4TG/kinetograph --skill kinetograph -a claude-code, then open ~/.claude/skills/kinetograph/SKILL.md.

What does kinetograph do?

The skill routes video, animation, title-card, and sound-design requests to the matching kinetograph-* skill. It also defines a workflow for project creation, composition edits, frame checks, and rendering.

How does Kinetograph inspect video without a browser?

Kinetograph renders video without a browser. Inspection uses individual frames and the scene graph, while still, strip, onion, inspect, lint, and render handle checking and export.

Source text

SKILL.md · Apache-2.0
---
name: kinetograph
description: Entry point for making videos and motion graphics with Kinetograph, a video engine with no browser in it. Use first when asked to build, edit, preview or render a video, animation, title card or sound design with Kinetograph, or to run any `kinetograph` command; it says which kinetograph-* skill to load next.
metadata:
  version: "0.4.0-rc.1"
---

# Kinetograph

Kinetograph renders video without a browser. You write TypeScript with the Remotion API and a few native elements (or an
HTML page with GSAP, and HyperFrames projects render as they are); Node runs it; a GPU compositor draws it. You cannot
watch a video, so you look at single frames and read the scene graph.

Run everything as `npx kinetograph <command>`. Add `--json` to get one JSON object you can parse; a failure is
`{ "error": { "code", "message" } }` with exit code 1. Over MCP (`kinetograph mcp`) there is one tool per command except
`studio`, named like the command (`audio analyze` is `audio_analyze`), with the same arguments; `still`, `strip` and `onion`
return the image itself.

## Which skill

Load the one that fits the step, and read its SKILL.md before you act. They are installed together.

| When | Skill |
|---|---|
| Start a project or a composition, add a component, template or taste | `kinetograph-create` |
| Write or change a composition: layout, text, media, effects, sound, fonts, timing, plugins, what the engine draws | `kinetograph-markup` |
| Look at frames, check, export (`still`, `strip`, `onion`, `inspect`, `lint`, `render`, `doctor`) | `kinetograph-render` |
| The person wants to preview, mark up, tune props or answer a panel in Studio | `kinetograph-studio` |
| Look something up in the Kinetograph docs | `kinetograph-docs` |
| Update `kinetograph`, its packages and these skills | `kinetograph-upgrade` |
| Move an existing Remotion project onto Kinetograph | `kinetograph-migrate` |

## The loop

1. **Create** the project once (`kinetograph-create`).
2. **Write** the composition (`kinetograph-markup`).
3. **Look and check**: `strip` first, then `lint` and `inspect` (`kinetograph-render`). Fix and repeat; a still takes well
   under a second.
4. **Render** to a file (`kinetograph-render`).

Rendering is a pure function of the frame number: nothing reads the clock, and `random(seed)` is Remotion's.

## Out-of-date notices

If a Kinetograph command prints that the CLI or the skills are out of date (a line on stderr, a `notices` field in
`--json`, or an extra text part on the first MCP tool result), tell the user and ask whether to update. Don't update
without a yes; then use `kinetograph-upgrade`.

© 0xS4N4TG · Apache-2.0 · 0xS4N4TG/kinetograph

Similar skills

All skills for Design →

From the same set8

kinetograph-docs The kinetograph-docs skill for Claude Code searches documentation on kinetograph.dev and reads pages as Markdown. It activates when looking up CLI flags, guides, or compatibility lists for Kinetograph. CX Codex +1 ★ 542repo stars kinetograph-create kinetograph-create is a Claude Code skill that scaffolds video projects and pulls templates from the Kinetograph registry. Triggers when starting a video from scratch or running project setup. CX Codex +1 ★ 542repo stars kinetograph-upgrade kinetograph-upgrade is a Claude Code skill that bumps the kinetograph CLI, its @kinetographdev/* packages, and agent skill files together whenever versions mismatch or fall behind. CX Codex +1 ★ 542repo stars kinetograph-studio kinetograph-studio is a Claude Code skill that connects an agent to the local Kinetograph Studio editor. It handles frame markups, timeline spans, and interactive review panels. CX Codex +1 ★ 542repo stars kinetograph-render kinetograph-render is a Claude Code skill that inspects, previews, and renders Kinetograph scenes. It generates frame strips, validates layout errors, and exports compositions to video. CX Codex +1 ★ 542repo stars kinetograph-markup kinetograph-markup is a Claude Code skill for writing and changing Kinetograph video scenes in TSX, HTML, or JSON. CX Codex +1 ★ 542repo stars kinetograph-migrate kinetograph-migrate is a Claude Code skill that moves Remotion projects to Kinetograph for browserless video rendering. Triggers when code imports remotion or uses remotion render scripts. CX Codex +1 ★ 542repo stars

Project sponsors

Companies that keep this analytics open