kinetograph-create — Claude Code skill: what it does, how to install
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.
Apache-2.0 ★ 542 updated 2026-11-17
npx skills add 0xS4N4TG/kinetograph --skill kinetograph-create -a claude-codeWhat kinetograph-create does
The skill sets up programmatic video projects using npx kinetograph init. It creates a starter composition in src/index.tsx sized 1280x720 at 30 fps across 60 frames, along with directories for scenes, reusable components, static assets, and generated outputs in out/. Passing --html creates an HTML layout powered by a GSAP timeline instead of TSX.
It generates package.json with scripts for still, strip, render, and check, keeping kinetograph as the only dependency. It pulls API imports exclusively from @kinetographdev/core and forbids installing remotion. Registry items drop into src/components/, src/templates/, or src/tastes/ via npx kinetograph add, leaving existing modified files untouched unless --overwrite is explicitly passed.
What it helps with
- scaffold a TSX video project with a default 1280x720 composition
- generate an HTML animation setup based on a GSAP timeline
- download components, reel templates, or styles from the Kinetograph registry
- configure build and render scripts outputting to the out directory
Example prompts for the agent
- Initialize a new Kinetograph project in this directory
- Set up an HTML animation project with a GSAP timeline
- Add a template from the Kinetograph registry
How to install kinetograph-create
1Skills CLI (Vercel)
npx skills add 0xS4N4TG/kinetograph --skill kinetograph-create -a claude-code2Manually: put the files in place
~/.claude/skills/kinetograph-create/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/kinetograph-create/
1Skills CLI (Vercel)
npx skills add 0xS4N4TG/kinetograph --skill kinetograph-create -a codex2Manually: put the files in place
.agents/skills/kinetograph-create/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add 0xS4N4TG/kinetograph --skill kinetograph-create -a cursor2Manually: put the files in place
.cursor/skills/kinetograph-create/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install 0xS4N4TG/kinetograph packages/cli/skills/kinetograph-create2Manually: put the files in place
.github/skills/kinetograph-create/SKILL.md1Skills CLI (Vercel)
npx skills add 0xS4N4TG/kinetograph --skill kinetograph-create -a gemini-cli2Platform CLI
gemini skills install https://github.com/0xS4N4TG/kinetograph --path packages/cli/skills/kinetograph-createManually: put the files in place
.devin/skills/kinetograph-create/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-create
How to install kinetograph-create in Claude Code?
Run npx skills add 0xS4N4TG/kinetograph --skill kinetograph-create -a claude-code.
What does kinetograph-create do?
It bootstraps folder structures, npm scripts, and starter compositions for Kinetograph video projects, and pulls components from the registry.
Can Remotion be used alongside Kinetograph?
No, Kinetograph forbids installing remotion. All composition helpers and APIs must be imported from @kinetographdev/core.
Source text
SKILL.md · Apache-2.0
---
name: kinetograph-create
description: Start a new Kinetograph project or add to one. Use when the folder has no Kinetograph project yet, when asked for a new video from scratch, or to install a component, template or taste from the registry with `kinetograph init` and `kinetograph add`.
metadata:
version: "0.4.0-rc.1"
---
# Create a Kinetograph project
## A new project
Run `npx kinetograph init [dir]` in an empty folder (`--html` starts an HTML page instead of TSX), keep the layout it
makes, then `npm install`. `init` skips files that already exist.
```
src/index.tsx registerRoot and the compositions (starter: composition "Main", 1280x720, 60 frames at 30 fps)
src/scenes/ one file per scene; reusable pieces in src/components/, helpers in src/lib/
html/index.html with --html: a page with a GSAP timeline, instead of src/
public/ assets for staticFile(): images/, fonts/, audio/, video/
out/ everything generated: renders/, stills/, sheets/
```
It also writes `package.json` (scripts `still`, `strip`, `render`, and `check` for TSX or `lint` for HTML; `kinetograph` is
the only dependency), `tsconfig.json` (TSX) and `.gitignore`. Check it with `npx kinetograph strip src/index.tsx`, then
go on with `kinetograph-markup`.
An existing project keeps its own layout; never move its files.
- Import the API from `@kinetographdev/core`, which comes with `kinetograph`. Never install `remotion`.
- Load assets with `staticFile('images/logo.png')`.
- Never write outputs next to the code or at the project root. `still`, `strip`, `onion` and `render` write to `out/` when
you leave out `-o`, and print the path.
- A second composition is another `<Composition id>` under `registerRoot`; pick it with `--comp <id>`.
## Components, templates and tastes
Don't rewrite what the registry has. `npx kinetograph add --list` shows it (`--type component|template|taste` narrows it);
`npx kinetograph add <name…>` installs:
- a component into `src/components/<name>/`, a template (a whole reel) into `src/templates/<name>/`, a taste (a reusable
style) into `src/tastes/<name>/`;
- their assets into `public/<kind>/<name>/`, and the registry items they depend on.
It never overwrites a file you changed (`--overwrite` does). It installs the npm packages an item needs only with `--yes`
(or a yes at a terminal); with `--json` it prints the command and does not run it. `--dir <folder>` names the project.
Read what it prints under `next:` for the import line.
To make a taste from a reference reel, use `kinetograph-taste-clone` (from the kinetograph-ui repo, if installed).
© 0xS4N4TG · Apache-2.0 · 0xS4N4TG/kinetograph