Agent skill

write-issue

Writing and maintaining GitHub issues for the tldraw repository. Use when creating new issues, editing issue titles/bodies, triaging issues, or cleaning up issue metadata (types, labels).

View SKILL.md on GitHub Repository
Stars 46,144
Forks 3,119

Install this agent skill to your Project

npx add-skill https://github.com/tldraw/tldraw/tree/main/.claude/skills/write-issue

SKILL.md

Writing and maintaining GitHub issues

Standards for issues in tldraw/tldraw.

Title standards

  • Sentence case - Capitalize only the first word and proper nouns
  • No type prefixes - Use GitHub issue types, not Bug:, Feature:, [Bug], etc.
  • Imperative mood for enhancements - "Add padding option" not "Adding padding option"
  • Descriptive for bugs - Describe the symptom: "Arrow bindings break with rotated shapes"
  • Specific - Readable without opening the issue body

Good titles

  • Arrow bindings break with rotated shapes
  • Add padding option to zoomToFit method
  • Pinch zoom resets selection on Safari

Bad titles

  • Bug: arrow bug (prefix, vague)
  • [Feature] Add new feature (prefix, vague)
  • Not working (vague)

Title cleanup transformations

  1. Remove prefixes: Bug: X → X
  2. Fix capitalization: Add Padding Option → Add padding option
  3. Use imperative: Adding feature X → Add feature X
  4. Be specific: Problem → [Describe the actual problem]
  5. Translate non-English titles to English

Issue types

Set via the GitHub GraphQL API after creating the issue (the --type flag is not reliably supported):

Type Use for
Bug Something isn't working as expected
Feature New capability or improvement
Example Request for a new SDK example
Task Internal task or chore

Labels

Use sparingly (1-2 per issue) for metadata, not categorization.

Common labels

Label Use for
good first issue Well-scoped issues for newcomers
More Info Needed Requires additional information
sdk Affects the tldraw SDK
dotcom Related to tldraw.com
a11y Accessibility
performance Performance improvement
api API change

Automation labels (do not apply manually)

keep, stale, update-snapshots, publish-packages, major, minor, skip-release, deploy triggers

Issue body standards

Bug reports

  1. Clear description of what's wrong
  2. Steps to reproduce
  3. Expected vs actual behavior
  4. Environment details (browser, OS, version) when relevant
  5. Screenshots/recordings when applicable

Feature requests

  1. Problem statement - What problem does this solve?
  2. Proposed solution - How should it work?
  3. Alternatives considered
  4. Use cases

Example requests

  1. What API/pattern to demonstrate
  2. Why it's useful
  3. Suggested approach
  4. Which example category it belongs to

Triage workflow

New issues

  1. Verify sufficient information to act on
  2. Set appropriate issue type
  3. Clean up title if needed
  4. Add More Info Needed label and comment if details missing
  5. Add good first issue if appropriate

Stale issues

  1. Review if still relevant
  2. Close if no longer applicable
  3. Add keep label if should remain open
  4. Request updates if waiting on information

Important

  • Never include "Generated with Claude Code" unless the PR directly relates to Claude Code
  • Never use title case for descriptions - use sentence case

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

tldraw/tldraw

convert-web-app

This skill should be used when the user asks to "add MCP App support to my web app", "turn my web app into a hybrid MCP App", "make my web page work as an MCP App too", "wrap my existing UI as an MCP App", "convert iframe embed to MCP App", "turn my SPA into an MCP App", or needs to add MCP App support to an existing web application while keeping it working standalone. Provides guidance for analyzing existing web apps and creating a hybrid web + MCP App with server-side tool and resource registration.

46,144 3,119
Explore
tldraw/tldraw

add-app-to-server

This skill should be used when the user asks to "add an app to my MCP server", "add UI to my MCP server", "add a view to my MCP tool", "enrich MCP tools with UI", "add interactive UI to existing server", "add MCP Apps to my server", or needs to add interactive UI capabilities to an existing MCP server that already has tools. Provides guidance for analyzing existing tools and adding MCP Apps UI resources.

46,144 3,119
Explore
tldraw/tldraw

migrate-oai-app

This skill should be used when the user asks to "migrate from OpenAI Apps SDK", "convert OpenAI App to MCP", "port from window.openai", "migrate from skybridge", "convert openai/outputTemplate", or needs guidance on converting OpenAI Apps SDK applications to MCP Apps SDK. Provides step-by-step migration guidance with API mapping tables.

46,144 3,119
Explore
tldraw/tldraw

create-mcp-app

This skill should be used when the user asks to "create an MCP App", "add a UI to an MCP tool", "build an interactive MCP View", "scaffold an MCP App", or needs guidance on MCP Apps SDK patterns, UI-resource registration, MCP App lifecycle, or host integration. Provides comprehensive guidance for building MCP Apps with interactive UIs.

46,144 3,119
Explore
tldraw/tldraw

pr-walkthrough

Create a narrated video walkthrough of a pull request with code slides and audio narration. Use when asked to create a PR walkthrough, PR video, or walkthrough video.

46,144 3,119
Explore
tldraw/tldraw

write-docs

Writing SDK documentation for tldraw. Use when creating new documentation articles, updating existing docs, or when documentation writing guidance is needed. Applies to docs in apps/docs/content/.

46,144 3,119
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results