Skip to content
Skip to content
AI & scripting

Chorono agent skills

A skill is a folder of instructions and references an agent can load for a task. Chorono provides two skills. MCP supplies the live editor tools; the CLI installs and starts the local software.

The two skills#

SkillUse it forMain instructions
chorono-setupInstallation, starting/stopping, MCP client configuration, readiness checks and skill managementSKILL.md
choronoEditable 2D scenes, layers, keyframes, multiple animations, particles, interaction, previews and saved projectsSKILL.md

Install both for the complete workflow. Once an editor is connected, the agent can use the authoring skill directly.

See both skills in a complete task: create and revise a Chorono animation with Codex. The walkthrough shows the editor connection, a precise prompt, preview checks and the saved project.

Source structure#

skills/
├── chorono-setup/
│   ├── SKILL.md
│   └── agents/openai.yaml
└── chorono/
    ├── SKILL.md
    ├── agents/openai.yaml
    └── references/
        ├── connection.md
        ├── animation.md
        ├── interaction.md
        └── media-and-output.md

SKILL.md contains the skill name, description and operating instructions. agents/openai.yaml provides client-facing metadata. The authoring references cover connection, animation, interaction, and media/output, so the agent reads details relevant to the task.

The canonical editable sources are in skills/. npm run cli:build copies them into packages/cli/skills/ and creates a SHA-256 manifest for distribution. That generated directory is not edited by hand.

Install with the Chorono CLI#

The full setup already installs the skills for selected Codex/Claude Code clients. For skills alone, run from the checkout:

npm run cli:build
npm run skills -- list
npm run skills -- install --dry-run
npm run skills -- install
npm run skills -- check

These skill commands use the local bundle; they do not download a newer copy from npm or GitHub. --dry-run shows the planned changes without installing them.

ScopeCodexClaude Code
Project, default<project>/.agents/skills/<project>/.claude/skills/
User, --global~/.agents/skills/~/.claude/skills/

Choose a client, an existing project or an individual skill:

npm run skills -- install --agent codex
npm run skills -- install --project "../my-animation" --agent claude-code
npm run skills -- install --global --agent codex --skill chorono --skill chorono-setup

Use --agent all for both supported filesystem clients. --global and --project cannot be combined. skills install requires an existing project directory; full setup --project can create one. Claude Desktop's MCP configuration does not make it load these filesystem skill directories.

Alternative: install instructions from GitHub#

With the third-party skills CLI and Node.js 22.20+, run inside your animation project:

npx skills add codie1982/chorono-editor --skill chorono --skill chorono-setup -a claude-code -a codex --copy

For a user-wide install, add -g. --copy selects copied files. See the tool's installation options. This method installs instructions; continue with the editor and MCP installation to make scene tools available.

Keep using the installer that owns a given copy. Chorono's CLI treats copies without its .chorono-skill.json metadata as foreign, including copies installed by another tool; it preserves them. Symlink destinations are refused by the Chorono CLI.

Update and inspect status#

After obtaining the desired source version, rebuild the bundle and update:

npm run cli:build
npm run skills -- check
npm run skills -- update --dry-run
npm run skills -- update
StatusMeaning / next step
currentMatches this CLI bundle
missingInstall the skill
differentUnmodified managed copy from another bundle; use update
modifiedLocal changes detected; review and preserve them
foreignCopy not managed by this CLI; review its installation source

check compares against the running package's manifest, not npm latest. update preserves modified or foreign copies. After reviewing a specific conflict, --force on install/update backs up the replaced directory under <scope>/.chorono/skill-backups/. Unrelated skills are not removed.

Start a new agent session after installation or update. Verify that the client has loaded the skills and MCP tools; a skill folder alone cannot register tools in an already open chat.

Use the skills#

Follow the MCP connection guide to verify the intended editor session, then try a focused revision in Your first animation.

For setup, ask: “Use chorono-setup to prepare this animation project, start the editor and check MCP readiness.” For authoring, ask: “Use chorono to animate a title and shapes, inspect preview frames and save the editable project.”

The authoring workflow reads the scene and capabilities, preserves unrelated content, uses revision checks, commits dry-run script plans without replaying them, inspects real preview images, validates and saves. Scripts use the isolated MCP bridge. See the MCP reference and maintainer distribution guide for technical details.

A good place to start
Getting started / Chorono documentationChorono documentationLearn Chorono with editable animation examples. Install the editor, edit keyframes, build loops and connect Claude Code or Codex through MCP. Cre…Getting started / Install ChoronoInstall ChoronoSet up the free, open-source animation editor on your computer and start a local browser session. This guide installs the browser editor, its loc…Getting started / Create your first editable animationCreate your first editable animationOpen an editable Chorono example, change its text and colors, inspect the timeline, then save and reopen your first 2D animation. Start with a re…Workspace / Chorono editor workspaceChorono editor workspaceFind the canvas, layers, properties, timeline and resource tools in the Chorono editor. Choose a guide for each part of your animation workflow.…Workspace / Canvas and drawing toolsCanvas and drawing toolsNavigate the canvas, draw shapes and splines, use snapping and edit motion keys in Chorono. Use the canvas to arrange the objects in your composi…Workspace / Choose a drawing or transform toolChoose a drawing or transform toolUse Select, Pan, Pen, Move, Rotate, Scale and Anchor tools without losing track of the active editing mode. Choose the tool that matches the edit…Workspace / Select exactly the objects you needSelect exactly the objects you needUse box, lasso, circle, paint and rule-based selection to work with several animation layers. When several objects overlap, clicking each one can…Workspace / Align objects with guides and snappingAlign objects with guides and snappingSet grid, object, point, guide, pixel, angle and scale snapping for precise placement in Chorono. Snapping helps a dragged object settle on an ex…Workspace / Edit Bézier points and spline curvesEdit Bézier points and spline curvesDraw editable paths, adjust points and handles, and extend or close a spline in Chorono. A curve is easier to control when you can see the points…Workspace / Edit animation positions on the canvasEdit animation positions on the canvasUse Motion Keys to adjust position keys, draw a movement and control how the path is timed. Motion Keys bring position editing onto the canvas. T…Workspace / Layers and scene hierarchyLayers and scene hierarchySelect, name, group and organize scene objects in Chorono using the Layers panel and Scene Explorer. A layer is an editable object in your Choron…Workspace / Draw and edit basic shapesDraw and edit basic shapesCreate rectangles, circles, polygons and procedural shapes, then adjust their geometry in Properties. Basic shapes are a useful starting point fo…
Explore the docs