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
npx skills add 0xS4N4TG/kinetograph --skill kinetograph -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/kinetograph/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/kinetograph/
1Skills CLI (Vercel)
npx skills add 0xS4N4TG/kinetograph --skill kinetograph -a codex2Manually: put the files in place
.agents/skills/kinetograph/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add 0xS4N4TG/kinetograph --skill kinetograph -a cursor2Manually: put the files in place
.cursor/skills/kinetograph/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install 0xS4N4TG/kinetograph packages/cli/skills/kinetograph2Manually: put the files in place
.github/skills/kinetograph/SKILL.md1Skills CLI (Vercel)
npx skills add 0xS4N4TG/kinetograph --skill kinetograph -a gemini-cli2Platform CLI
gemini skills install https://github.com/0xS4N4TG/kinetograph --path packages/cli/skills/kinetographManually: put the files in place
.devin/skills/kinetograph/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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