Skip to main content
skill CX Codex

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

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.

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

What kinetograph-upgrade does

This skill runs a synchronized upgrade of the Kinetograph stack in a project. It starts by prompting for approval, checks current versions via npx kinetograph doctor, and inspects changelog files for renamed flags.

Packages upgrade in a single npm install command to maintain exact peer alignments with @kinetographdev/core. A second version appearing under npm ls @kinetographdev/core indicates an outdated plugin that must be updated or held back.

The workflow executes npx kinetograph skills update to refresh agent files across ~/.claude/skills, ~/.codex/skills, and ~/.cursor/skills. Validation runs through doctor, check, and project snapshot tests.

What it helps with

  • upgrade the kinetograph CLI and its companion plugins together
  • resolve dependency mismatches in @kinetographdev/core
  • sync agent markdown files across Claude Code, Codex, and Cursor directories
  • validate project entry points using doctor, lint, and snapshot checks

Example prompts for the agent

  • Update Kinetograph and its plugins to latest
  • Run kinetograph doctor and update our agent skills
  • Resolve the Kinetograph version mismatch error

How to install kinetograph-upgrade

1Skills CLI (Vercel)

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

2Manually: put the files in place

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

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

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

Questions about kinetograph-upgrade

How to install kinetograph-upgrade in Claude Code?

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

What does kinetograph-upgrade do?

It verifies version parity, updates kinetograph alongside its @kinetographdev/* packages in one step, and refreshes skill files across agent folders.

What is required to run kinetograph-upgrade?

It requires Node.js, npm, and a project that contains the kinetograph dependency.

Source text

SKILL.md · Apache-2.0
---
name: kinetograph-upgrade
description: Upgrade Kinetograph in a project: the `kinetograph` CLI, its `@kinetographdev/*` packages and plugins together, and the installed agent skills. Use when a command says the CLI or the skills are out of date, when asked to update or bump Kinetograph, or after a version mismatch error.
metadata:
  version: "0.4.0-rc.1"
---

# Upgrade Kinetograph

Ask the user before you change anything: the CLI only prints a notice (once a day, off in CI and with
`KINETOGRAPH_NO_UPDATE_CHECK=1`) and never installs. Go ahead on a yes.

## How the versions fit

- `kinetograph` pins each of its `@kinetographdev/*` dependencies (`core`, `audio`, `compat`, `scene`, `native`, `studio`) to
  its own exact version. Upgrading `kinetograph` moves them all; never pin one of them separately.
- A plugin (`@kinetographdev/gsap`, `anime`, `motion`, `p5-brush`, or one from elsewhere) is its own package with a peer
  range on `@kinetographdev/core`, such as `^0.2.0 || ^0.3.0`. While the version is 0.x, `^0.3.0` means 0.3.x only, so a new
  minor of `kinetograph` needs a plugin release that lists it. `@kinetographdev/studio` peers on the exact `kinetograph`.
- The agent skills carry `metadata.version` in their SKILL.md. A skill is current when it is at least the CLI's version.

## Steps

1. **Look.** `npx kinetograph doctor` prints the CLI against the latest on npm and each installed skill with its version and
   whether it is current. `npm outdated kinetograph` and `npm ls kinetograph` show what the project has; check the
   project's `package.json` for `@kinetographdev/*` entries.
2. **Read what changed.** The changelog is `CHANGELOG.md` in the repository and `https://kinetograph.dev/llms.mdx/changelog.md`
   (see `kinetograph-docs`). Note any renamed flag or API.
3. **Upgrade the packages in one command**, so npm resolves them together: `npm install kinetograph@latest` plus every
   `@kinetographdev/*` plugin the project lists, each at `@latest`. Then `npm ls @kinetographdev/core` must show one version;
   a second copy means a plugin is behind (install its newer release, or hold `kinetograph` back).
4. **Refresh the skills.** `npx kinetograph skills update` (no questions). It writes every skill of the installed
   package, and `kinetograph-taste-clone`, into the user-wide skills folders of Claude Code, Codex and Cursor
   (`~/.claude/skills`, `~/.codex/skills`, `~/.cursor/skills`, `~/.agents/skills`). Then `npx kinetograph doctor` again; every skill should say `current`.
5. **Check the project.** `npx kinetograph check <entry>` (TSX), `lint`, `doctor <entry>` and `strip` (see
   `kinetograph-render`); `snapshot <entry>` if approved frames exist, to see what moved. Fix what the changelog says
   changed.

Skills from other repos update with their own `npx skills add`.

© 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-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