About issue
issue is a skill for drafting and managing GitHub issues with concise, context-preserving titles and correctly formatted Markdown. It also covers attachment handling, post-edit verification, and issue relationships through the issue-management skill.
Key features
- 01Preserve user framing in titles
- 02Use package or area prefixes
- 03Write multiline bodies via files
- 04Attach images and videos
- 05Verify issue content after edits
- 06Refer issue relationships to another skill
Use cases
- 01Drafting a clearly titled GitHub issue
- 02Creating issues with multiline Markdown
- 03Adding screenshots or video to an issue
- 04Checking issue content after editing
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ remotion-dev/ remotion --skill issueAfter installing, type/issuein Claude Code to confirm it loaded.
Details
From the project READMETitles
Write a concise title that preserves the user's framing. An issue may describe a problem or give a directive; do not turn a problem into a prescribed solution unless the user supplied or explicitly requested one.
Prefix package-specific issues with the package name:
`@remotion/package`: Issue description
For broader areas, use the corresponding prefix:
Docs: Issue description
Studio: Issue description
Build: Issue description
CI: Issue description
Repo: Issue description
Avoid vague titles such as Bug, Fix issue, or Examples follow-up.
Markdown bodies and comments
Never pass multiline Markdown inline through shell arguments. Write issue bodies and multiline comments to a temporary Markdown file, preferably with the write tool, and pass it with --body-file.
After creating or editing an issue, verify its title and body:
gh issue view <number> --json title,body
Confirm that the content is correct and multiline Markdown contains real newlines rather than literal \n sequences.
Attachments
When the user provides an image or video, upload it with --attach on gh issue create, edit, or comment:
gh issue edit <number> --attach '/tmp/screenshot.png#Description of the screenshot'
Repeat the flag for multiple files. Images support alt text after #; videos do not. Attachments are appended, or matching local Markdown references are rewritten to uploaded URLs. Editing with only --attach preserves the existing body.
If an upload partially fails, inspect the issue before retrying to avoid duplicates. See gh issue <command> --help for details.
Relationships
For parent issues, sub-issues, blocked-by, and blocking relationships, use the issue-management skill.