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
npx skills add 0xS4N4TG/kinetograph --skill kinetograph-upgrade -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/kinetograph-upgrade/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/kinetograph-upgrade/
1Skills CLI (Vercel)
npx skills add 0xS4N4TG/kinetograph --skill kinetograph-upgrade -a codex2Manually: put the files in place
.agents/skills/kinetograph-upgrade/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add 0xS4N4TG/kinetograph --skill kinetograph-upgrade -a cursor2Manually: put the files in place
.cursor/skills/kinetograph-upgrade/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install 0xS4N4TG/kinetograph packages/cli/skills/kinetograph-upgrade2Manually: put the files in place
.github/skills/kinetograph-upgrade/SKILL.md1Skills CLI (Vercel)
npx skills add 0xS4N4TG/kinetograph --skill kinetograph-upgrade -a gemini-cli2Platform CLI
gemini skills install https://github.com/0xS4N4TG/kinetograph --path packages/cli/skills/kinetograph-upgradeManually: put the files in place
.devin/skills/kinetograph-upgrade/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-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