tldraw-migrate skill
The official tldraw skill for upgrading a project to a newer SDK version: detects versions, fetches release notes and fixes type errors
- 51,136 ★ on the repository
- Last commit
Extended access
Why this level
- Runs Node scripts and calls GitHub and npm
- Changes project dependencies and code
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/tldraw-migrateDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Runs Node scripts and calls GitHub and npm
- Changes project dependencies and code
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.
Good fit when
- You need to bump tldraw to the latest stable version
- TypeScript errors appeared after a tldraw upgrade
- You want to test the project on a canary or beta prerelease
Not a fit when
- The project does not use the tldraw SDK
- You are working on the tldraw repository itself: its other skills serve the tldraw team
Example request
/tldraw-migrate 4.4.0 latestLimitations
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.
FAQ
How do I update the skill?
Re-run the install command to overwrite SKILL.md and the scripts. Release notes are fetched on every run.
What arguments does it take?
An optional source version and target: latest by default, a tag such as canary or a specific prerelease version.
Discussion
No questions or reviews yet.
Related
SkillsA skill that designs UI and landing page mockups and rebuilds screenshots as HTML, a React project or a WeChat mini program
A skill that dissects and ports WebGL, WebGPU and Canvas effects from a page into a standalone local JS project
Tamagui skill for agents
Tamagui
Four skills in the Tamagui repository: styling and themes, migration to version 3, the v6 theme family and a palette generator with preview
A skill and CLI that pull colors, type, spacing, radius and shadows from a public site and save them as JSON and CSS tokens
A skill methodology for reproducing websites, from a static page to heavy WebGL, built on real source code rather than agent-hallucinated code
Meta-skill that reads a brand from a URL, name or screenshot and turns it into a full design system as a new skill
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.
README badge
Original 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.