Skip to main content
skill CX Codex

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

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.

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-studio -a claude-code
Open on GitHub

What kinetograph-studio does

The skill boots the local Kinetograph Studio editor at http://127.0.0.1:3000 using npx kinetograph studio <entry>. The entry point takes a project file, a .json scene, or a HyperFrames page. The interface provides an audio preview, timeline selection, scene hierarchy, render queue, and direct export to .mp4 or .mov.

When hooked via MCP using KINETOGRAPH_STUDIO_TOKEN, the agent inspects and adjusts composition props through studio_get_props and studio_set_props. It runs decision stages like briefs, storyboards, and reviews via studio_open_panel, waiting for answers stored in plan/<panel>.json.

Passing --host to expose the studio to other machines keeps the agent disabled unless --allow-remote-agent is explicitly supplied.

What it helps with

  • inspect and update composition props using studio_get_props and studio_set_props
  • process visual frame markups and timestamps from Markup notes on inputs
  • gather approvals for briefs, scripts, and storyboards via built-in panels
  • export video ranges to .mp4 or .mov files through the render queue

Example prompts for the agent

  • Launch studio for scene.json
  • Markup notes on MainComp: move the title banner 20 pixels left
  • Open a storyboard panel to review scene timings

How to install kinetograph-studio

1Skills CLI (Vercel)

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

2Manually: put the files in place

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

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

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

Questions about kinetograph-studio

How do I install kinetograph-studio in Claude Code?

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

What does kinetograph-studio do?

It launches a local video editing app at http://127.0.0.1:3000 and routes timeline selections, frame notes, and review panels to your coding agent.

What is required to run kinetograph-studio over MCP?

You need an active studio session via kinetograph mcp --studio <address> and an authentication token set in KINETOGRAPH_STUDIO_TOKEN.

Source text

SKILL.md · Apache-2.0
---
name: kinetograph-studio
description: Open Kinetograph Studio, the local editor with a live preview, timeline, props and presets, export and a chat with the coding agent, and work with the person in it. Use when the person wants to preview or tune a video, mark up frames, give you a span of time, answer a brief, storyboard or review panel, or when a message starts with "Markup notes on".
metadata:
  version: "0.4.0-rc.1"
---

# Work in Studio

`npx kinetograph studio <entry>` starts the local studio (a preview that plays sound, a timeline you can drag a span on,
props and presets, plugin cards, a scene tree, an export dialog, a render queue and a chat with the person's coding agent)
at `http://127.0.0.1:3000` and opens a browser. The entry is a project file, a `.json` scene, or a HyperFrames page. It
rebuilds when a file changes and runs until stopped. It is for the person at the screen and is not an MCP tool.

Options: `--port N` (0 picks a free one), `--host`, `--no-open` (use it when you start Studio yourself), `--agent <command>`
(the coding agent for the chat; default Claude Code, Codex or Gemini CLI, whichever is installed), `--allow-remote-agent`,
`--props <json>`, `--offline`. With `--host` set so other computers can reach Studio, the agent is off unless
`--allow-remote-agent` is passed.

## What the person has

- **Preview and timeline.** Click a layer to select it. Drag across the timeline ruler or a clip to pick a span of time. Each
  message you receive carries the selection: the project file, the composition, the frame or span, and for each layer its
  name, kind, source file and line, position, size, look and plugin. For a span you get the Sequences that overlap it and a
  contact sheet of up to eight frames.
- **Props tab.** A form drawn from the composition's zod `schema`; edits re-render the preview. **Presets** save the props as
  `presets/<composition id>/<name>.json` beside the entry, and `--props` renders one from the command line.
- **Markup mode** (`M`): the person pins a spot, boxes a region, draws, or marks a range, with a comment on each.
- **Export** (top bar): a range, a `.mp4` or `.mov` path and Draft; it joins the Renders queue.

## Tools

Over MCP, with the studio open (`kinetograph mcp --studio <address>`, the token in `KINETOGRAPH_STUDIO_TOKEN`; Studio's own
chat agent has them already):

- `studio_get_props` reads the props the preview shows; `studio_set_props` changes them, and the person watches the preview
  change. Try values this way, then write the ones you choose into the code or a preset.
- `studio_open_panel` and `studio_panel_result` ask the person for a decision in a panel (below).

The chat agent also gets every `kinetograph` command and the tools of the project's plugins (`<plugin>_<tool>`).

## Markup notes

A message that starts `Markup notes on <comp>` is the person's notes drawn on the preview: a numbered list in time order
(frame, time, the mark in composition pixels, the layers under it, their comment), with each distinct frame attached as a
picture that has the marks drawn on it (`public/refs/markup-<stamp>-<n>.png`, the path is in the message). Fix the notes in
order, and end with a numbered list saying which you did and which you skipped and why. Frames over the cap come without a
picture: use the frame number and the coordinates. Images the person attaches are stored in `public/refs/` too; use one
with `staticFile('refs/name.png')`.

## Panels for a new video

Settle the decisions in order before you animate, using `studio_open_panel`: a **brief** first (pre-fill what you know
from the chat), then the script or track, then a **storyboard**, then the look (`styleframes`). Build an animatic and ask
for a **review** before animating; animate the hook and the reveal first and ask for a review again. Skip stages that
don't fit the job (a caption fix needs no brief). Never animate against an unapproved storyboard without saying so.

- `studio_open_panel({ panel, data, message?, placement? })` opens `brief`, `script`, `storyboard`, `styleframes`, `review` or
  `custom` and returns `{ id, status: 'open' }` at once. `data` is what the panel starts from: a partial `Brief`; a
  `Storyboard` (`comp` and `shots`); a `ReviewRequest` (`comp`, `range?`, `ask?`). `message` is one line shown at the top.
  Opening a second panel of the same kind replaces the first.
- `studio_panel_result({ id })` returns `{ status: 'open' | 'submitted' | 'dismissed', answer? }`. Use it only when the
  person tells you in a terminal that they answered.

After you open a panel, end your turn with one line saying what you are waiting for. Do not start the next stage and do not
call the tool again to check. The answer arrives as a message starting `[panel <kind> <id> submitted]`, or `dismissed` if
the person closed it. Read `plan/<panel>.json` before you build from it.

For a one-off question the built-in panels do not fit, use `panel: 'custom'`; the block types and the answer shape are in
`references/panels.md`.

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

Similar skills

All skills for Agent setup: memory, context, orchestration →

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 kinetograph is a Claude Code skill that routes video and motion-graphics work to the right next skill for building, checking, or rendering. 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-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