How do I install the Write Issue skill?

Run npx skillmds@latest add mahabdalla/write-issue in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Write Issue safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Write Issue?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Write Issue free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Write Issue?

mahabdalla (@mahabdalla) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Write Issue by mahabdalla — Agent Skill

Name: Write Issue
Rating: 4.2 (5 reviews)
Author: mahabdalla

File contents

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

Remove prefixes: Bug: X → X
Fix capitalization: Add Padding Option → Add padding option
Use imperative: Adding feature X → Add feature X
Be specific: Problem → [Describe the actual problem]
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

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

Feature requests

Problem statement - What problem does this solve?
Proposed solution - How should it work?
Alternatives considered
Use cases

Example requests

What API/pattern to demonstrate
Why it's useful
Suggested approach
Which example category it belongs to

Triage workflow

New issues

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

Stale issues

Review if still relevant
Close if no longer applicable
Add keep label if should remain open
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

Converted and distributed by TomeVault | Claim this content

---name: write-issuedescription: 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).---# Writing and maintaining GitHub issuesStandards 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 transformations1. 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 typesSet 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 |## LabelsUse 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 reports1. Clear description of what's wrong2. Steps to reproduce3. Expected vs actual behavior4. Environment details (browser, OS, version) when relevant5. Screenshots/recordings when applicable### Feature requests1. Problem statement - What problem does this solve?2. Proposed solution - How should it work?3. Alternatives considered4. Use cases### Example requests1. What API/pattern to demonstrate2. Why it's useful3. Suggested approach4. Which example category it belongs to## Triage workflow### New issues1. Verify sufficient information to act on2. Set appropriate issue type3. Clean up title if needed4. Add `More Info Needed` label and comment if details missing5. Add `good first issue` if appropriate### Stale issues1. Review if still relevant2. Close if no longer applicable3. Add `keep` label if should remain open4. 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---> Converted and distributed by [TomeVault](https://tomevault.io) | [Claim this content](https://tomevault.io/claim/tldraw/tldraw)

Frequently asked questions

Write Issue