write-tbp_skill

Overview

This skill helps you write technical blog posts about tldraw features and implementation details. It guides research, discovery of an engaging angle, and drafting a focused post that explains why a solution exists and how it works in the tldraw codebase.

How this skill works

The skill prescribes a repeatable process: create a topic workspace, run a thorough codebase exploration to gather files and notes, identify the compelling technical angle, draft a structured post, and self-evaluate against a checklist. Research output and the draft are saved to a small assets folder so you can iterate and review before publishing.

When to use it

• Explaining how a specific tldraw subsystem (routing, sync, rendering) is implemented
• Turning tests, examples, or comments in the repo into a readable engineering article
• Documenting non-obvious design decisions or tradeoffs in the SDK
• Preparing a deep-dive for an engineering blog targeted at developers using tldraw
• Creating educational content that links directly to implementation files and examples

Best practices

• Use a short kebab-case topic name and create a dedicated assets/<topic>/ folder
• Run a thorough Explore step: collect files, key functions, tests, and 'why' comments
• Focus the draft on a clear problem, the surprising insight, and step-by-step implementation
• Include concrete code snippets that build understanding, not just show syntax
• Self-evaluate against checklist items: opening, insight, specificity, code, tone, links

Example use cases

• A post that explains arrow-routing: why naive approaches fail and how tldraw routes connectors
• A deep-dive into collaborative sync: what the protocol does and how conflicts are resolved
• An article on infinite canvas rendering optimizations and how tile culling is implemented
• A walkthrough of gesture handling in the React integration and event flow
• A tutorial that maps tests and examples to real implementation files for learners