Skip to main content
skill Claude Code CX Codex Cursor GitHub Copilot

write-release-notes — Claude Code skill for release notes

Creates and reviews tldraw SDK release-note articles from merged PRs, with migration guidance for breaking changes.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add tldraw/tldraw --skill write-release-notes -a claude-code
Open on GitHub

What write-release-notes does

This skill defines a workflow for published tldraw SDK release notes. Release articles live in apps/docs/content/releases/: next.mdx collects upcoming changes, while files such as vX.Y.0.mdx hold published versions. It starts with release details from gh release view, then finds merged PRs through git log or gh pr list.

For each PR, the skill calls for title, body, labels, author, and branch details through gh pr view <PR_NUMBER> --json title,body,labels,author,baseRefName. Only PRs merged into main belong in the release. That filter matters because feature-branch work has not shipped yet.

It guides the article structure for major changes, API updates, improvements, fixes, and patch releases. Every breaking change needs a migration recipe, either as a dedicated section with before-and-after code or as an explicit replacement in an API entry. The final check covers PR links, contributor credits, and section order.

What it helps with

  • find merged PRs between releases
  • exclude PRs merged to feature branches
  • create release articles under apps/docs/content/releases/
  • add migration steps for breaking API changes
  • review patch releases for a minor version

Example prompts for the agent

  • Draft tldraw SDK release notes for `v4.3.0` in `apps/docs/content/releases/`.
  • Find the PRs between `v4.2.0` and `v4.3.0` and outline the release article.
  • Review this release note and add migration recipes for every breaking change.

How to install write-release-notes

1Skills CLI (Vercel)

npx skills add tldraw/tldraw --skill write-release-notes -a claude-code

2Manually: put the files in place

~/.claude/skills/write-release-notes/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/write-release-notes/

From the same set7

The whole set →

Similar

doc-gen ruvnet Generates project documentation, detects drift between docs and code, and schedules recurring updates. Helpful when code changes outpace reference files. Claude Code CX Codex Cursor +1 743installs adr-create ruvnet Writes an Architecture Decision Record into docs/adr with the next number, stores it in AgentDB and links it to related decisions. Useful when a decision has to be recorded and findable later. Claude Code CX Codex Cursor +1 741installs ce-promote EveryInc Drafts launch posts and changelog blurbs directly from git diffs or pull requests. Useful for engineers who want ready-to-use release copy without waiting on marketing. Claude Code CX Codex Cursor +1 1,000installs wiki Yeachan-Heo Keeps a markdown knowledge base for the project in .omc/wiki/: pages, an index and an operation log that survive between sessions. Claude Code CX Codex Cursor +1 609installs adr-verify ruvnet Reads the stored ADR graph back and flags dangling references, supersede cycles and status mismatches. Useful right after adr-index or as a CI gate. Claude Code CX Codex Cursor +1 688installs ce-explain EveryInc A skill that explains how a piece of code or a stretch of work ended up in its current shape, with the evidence it used. For the reasoning, not the recommendation. Claude Code CX Codex Cursor +1 952installs grill-with-docs Matt Pocock This skill interviews you about a plan or design and creates ADRs and a glossary along the way. Use it when decisions need sharper definition. Claude Code 1,219,756installs skill-creator official anthropics Creates and refines skills, then tests them with prompts, evaluations, and performance checks. Claude Code Claude.ai 414,180installs

Questions about write-release-notes

How do I install write-release-notes in Claude Code?

Run npx skills add tldraw/tldraw --skill write-release-notes -a claude-code, then run npx skills add tldraw/tldraw --skill write-release-notes -a claude-code again. The skill file is located at ~/.claude/skills/write-release-notes/SKILL.md.

What does write-release-notes do?

It guides the creation and review of tldraw SDK release articles, from release and PR discovery through article structure and final checks.

How are breaking changes documented?

Each breaking change needs a migration recipe. Use a dedicated migration block for a featured change, or name the replacement and caveats directly in an API list entry.

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor