Write Pr
A reference guide for writing pull requests in the tldraw repository style. It enforces semantic commit titles (feat, fix, docs, etc.), structured PR bodies with change type checkboxes, test plans, and release notes. The standout piece is the "human notes" preservation rule: if a PR author wrote a personal intro marked with a person emoji, you leave it completely untouched when updating the description. Also includes guidance for large feature PRs with concept tables, API breakdowns, and FAQ sections that go above the standard template blocks. Treats PR descriptions as technical documentation with specific line-of-code change tables broken down by core code, tests, and tooling. More opinionated than you might expect, but if you work in a repository with PR standards, this kind of enforcement actually saves time.
- skills.sh installs
- 424
- GitHub stars
- 51.4K
- last updated
- Aug 21, 2026
Install
$ npx -y skills add tldraw/tldraw --skill write-pr --agent claude-codeInstalls into .claude/skills of the current project.
Files
Writing pull requests
Standards for PR titles and descriptions in tldraw/tldraw.
Write for the reviewer (read this first)
This is the governing rule; everything below serves it. Write the description for a reviewer who knows the codebase architecture but has not read your code or the diff. Their time is the scarce resource. The description's job is to give them the framing they can't get from the code, then get out of the way.
Default to short. A few sentences of framing is the norm, not the exception. Match length to the change: a one-line fix needs a sentence; a new system needs the fuller treatment. A description that looks long and structured is not more valuable — often it's less, because it buries the framing under scaffolding. If a reviewer would need their own AI to interpret yours, it has failed.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/tldraw/tldraw
- Categories
- Git & Pull Requests, Documentation, Automation & Workflows
- First seen
- Jun 3, 2026
More from tldraw/tldraw
All 15Recommended
More Git & Pull Requests
codex-reviewdavila7/claude-code-templatesProfessional code review with auto CHANGELOG generation, integrated with Codex AI365skills.sh installs
devtu-githubmims-harvard/tooluniverseGitHub workflow for ToolUniverse - push code safely by moving temp files, activating pre-commit hooks, running tests, and cleaning staged files. Use when pushin365skills.sh installs
githubdalestudy/skillsGitHub CLI(gh)를 활용한 GitHub 플랫폼 상호작용 가이드. 다음 상황에서 사용: (1) GitHub 이슈 생성, 조회, 수정 시, (2) Pull Request 생성, 리뷰, 병합 시, (3) GitHub 릴리스 생성 및 관리 시, (4) 레이블, 마일스톤 등 프로젝트 관349skills.sh installs
git-troubleshootinggeoffjay/claude-pluginsGit troubleshooting techniques including recovering lost commits, fixing merge conflicts, resolving detached HEAD, and diagnosing repository issues. Use when us346skills.sh installscreate-prdavila7/claude-code-templatesCreate pull requests following Sentry conventions. Use when opening PRs, writing PR descriptions, or preparing changes for review. Follows Sentry's code review 314skills.sh installs
create-prmarcelorodrigo/agent-skillsCreate Pull Requests following best conventions. Use when opening PRs, writing PR descriptions, or preparing changes for review.311skills.sh installs