# write-tbp

write-tbp guides drafting technical blog posts about tldraw architecture by gathering context straight from editor packages, types, and tests.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 169 installs · ★ 51527 repo stars
- Author: tldraw
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/tldraw/tldraw/tree/HEAD/skills/write-tbp/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/write-tbp

## What it does

This skill structures technical writing about tldraw internals. It sets up `assets/<topic>/` with separate files for notes and drafts. The agent scans `packages/editor` and tests.

The workflow bans artificial anecdotes and staged scenarios. Instead, the text focuses on real design trade-offs and early implementation bugs. Target length stays between 800 and 1500 words. The draft serves as plain raw material for human editing.

Workspace paths target tldraw directory names directly. Running this skill in a different repo without editing the paths will break file discovery.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add tldraw/tldraw --skill write-tbp -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/write-tbp/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/write-tbp/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add tldraw/tldraw --skill write-tbp -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/write-tbp/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add tldraw/tldraw --skill write-tbp -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/write-tbp/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install tldraw/tldraw skills/write-tbp
```

2. **Manually: put the files in place**
- File: `.github/skills/write-tbp/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add tldraw/tldraw --skill write-tbp -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/tldraw/tldraw --path skills/write-tbp
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/write-tbp/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add tldraw/tldraw --skill write-tbp -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/tldraw/tldraw/tree/HEAD/skills/write-tbp/SKILL.md

## When to use it
- audit tldraw subsystems through tests and architecture comments
- extract the core technical problem and counter-intuitive insights
- produce an 800-1500 word technical draft free of AI conversational fluff
- prepare clean engineering source material for a human editor

## Example prompts
- Draft a technical post about arrow-routing mechanics in the tldraw codebase
- Research how dash-patterns work in editor packages and save findings to research.md
- Generate an engineering blog draft about scribbles following the blog guide

## Similar
- [write-manual](https://affpapa.org/en/nevibecode/skills/write-manual.md) — skill · 1400 installs
- [technical-article-writer](https://affpapa.org/en/nevibecode/skills/technical-article-writer.md) — skill · 5600 installs
- [content-production](https://affpapa.org/en/nevibecode/skills/content-production.md) — skill · 704 installs
- [blog-writing-specialist](https://affpapa.org/en/nevibecode/skills/blog-writing-specialist.md) — skill · 269 installs
- [content-creator](https://affpapa.org/en/nevibecode/plugins/content-creator.md) — plugin · ★ 2858 repo stars
- [write](https://affpapa.org/en/nevibecode/skills/write.md) — skill · 16000 installs

From the same set: [tldraw/tldraw](https://affpapa.org/en/nevibecode/by/tldraw/tldraw.md) — 12 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
