tldraw-migrate

Install

DEST=.claude/skills/tldraw-migrate
mkdir -p "$DEST"
curl -fsSL https://github.com/tldraw/tldraw/archive/refs/heads/main.tar.gz \
  | tar -xz --strip-components=3 -C "$DEST" tldraw-main/skills/tldraw-migrate

This is third-party code. Review the repository files before installing.

What it does

The skill guides the agent through upgrading a project built on the tldraw SDK. Helper scripts detect the source version from git history and the target from npm, including canary and beta tags, then download the changelog, docs and upcoming release notes. The agent then follows the process: bump packages, collect TypeScript errors, group them and fix code using the migration notes. The skill is self-contained and works in Claude Code, Codex, Cursor and other agents that read skill folders.

Who it is for. For developers of apps built on the tldraw SDK who need to upgrade the library.

Example request

/tldraw-migrate 4.4.0 latest

Limitations

Requires Node.js and project git history to detect the source version. Scripts call GitHub and npm for release notes. Commands prefixed with ! auto-run only in Claude Code; other agents must run them manually. Commercial use of the tldraw SDK is governed by its own license.

How to disable. Remove the tldraw-migrate folder from .claude/skills, .agents/skills or another project skills directory.

Security check

• Runs Node scripts and calls GitHub and npm
• Changes project dependencies and code

README in short

tldraw is a React SDK for infinite canvas apps. The tldraw-migrate skill has its own README: it is distributed by copying the folder into the project's skills directory, with a one-line curl and tar command. It lists paths for Claude Code, Codex, Cursor and the shared .agents folder, and the docs site serves the skill through .well-known/agent-skills. The other skills in the repository are for the tldraw team.

SKILL.md

---
name: tldraw-migrate
description: Migrate a project to a newer version of the tldraw SDK. Use when upgrading tldraw packages, fixing TypeScript errors after a tldraw upgrade, or when the user mentions tldraw migration.
argument-hint: '[from-version] [target]'
user-invocable: true
---

# tldraw migration assistant

You are helping migrate a project to a newer version of the tldraw SDK. Follow this process carefully.

Throughout this skill, `${SKILL_DIR}` refers to this skill's own directory (where `SKILL.md`, the helper `.mjs` scripts, and the cached `references/` folder live). The auto-fetch blocks below resolve it from the `SKILL_DIR` env var if set, otherwise probe the common skill locations (`.claude/skills/`, `.agents/skills/`, `.codex/skills/`, `.cursor/skills/`, `skills/`).

**Arguments**: `/tldraw-migrate [from-version] [target]`. Both optional. `from-version` defaults to the previous tldraw version detected from git history. `target` defaults to `latest` (the latest stable release on npm); pass a dist-tag (`canary`, `next`, `beta`) or a pre-release semver (e.g. `4.6.0-canary.abc123`) to migrate to a pre-release.

Related