write-issue — Claude Code skill: what it does, how to install
Enforces GitHub issue formatting and triage standards based on the tldraw repository. It helps draft clear titles, structure descriptions, and manage labels.
npx skills add tldraw/tldraw --skill write-issue -a claude-codeWhat write-issue does
The skill standardizes GitHub issue creation according to conventions from the tldraw project. Titles must use sentence case without type prefixes such as Bug or Feature. Enhancements take the imperative mood, while bug titles describe the observed symptom directly. Non-English titles get translated into English so anyone can grasp the problem without opening the issue.
When drafting issues, the agent writes a concise product-level summary of the problem without file paths, code blocks, or implementation recipes. A numbered list of open questions follows, highlighting blocking items. At the very bottom, a confidence percentage shows whether enough context exists to begin work.
Setting the issue type requires a GitHub GraphQL API call because the --type CLI flag does not work reliably. The guidelines also explicitly forbid adding AI attribution lines unless the issue specifically concerns AI tooling.
What it helps with
- rewrite vague issue titles into clear sentence-case summaries
- organize bug reports with reproduction steps and environment details
- track unresolved questions and blocking details before implementation
- apply appropriate metadata labels without touching automation tags
Example prompts for the agent
- Draft a GitHub issue for pinch zoom resetting the selection in Safari
- Convert this bug report into a standard tldraw issue title and description
- Triage this feature request and list open blocking questions
How to install write-issue
1Skills CLI (Vercel)
npx skills add tldraw/tldraw --skill write-issue -a claude-code2Manually: put the files in place
~/.claude/skills/write-issue/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/write-issue/
1Skills CLI (Vercel)
npx skills add tldraw/tldraw --skill write-issue -a codex2Manually: put the files in place
.agents/skills/write-issue/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add tldraw/tldraw --skill write-issue -a cursor2Manually: put the files in place
.cursor/skills/write-issue/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install tldraw/tldraw write-issue2Manually: put the files in place
.github/skills/write-issue/SKILL.md1Skills CLI (Vercel)
npx skills add tldraw/tldraw --skill write-issue -a gemini-cli2Platform CLI
gemini skills install https://github.com/tldraw/tldraw --path skills/write-issueManually: put the files in place
.devin/skills/write-issue/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add tldraw/tldraw --skill write-issue -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set7
The whole set →Similar
Questions about write-issue
How do I install write-issue in Claude Code?
Run npx skills add tldraw/tldraw --skill write-issue -a claude-code in your terminal.
What does write-issue do?
It provides standards for writing titles, bodies, and triage labels for GitHub issues based on the tldraw workflow.
Why does write-issue use the GraphQL API for issue types?
The skill relies on the GitHub GraphQL API because the --type flag is not reliably supported when creating issues through the command line.
