| name | github-issue |
| description | Create well-structured GitHub issues following the Epic > Feature > Task/Bug
hierarchy. Uses GitHub issue types (not labels) and relationships to connect
related issues. Invoke with /github-issue.
|
| author | Claude Code |
| version | 1.1.0 |
| date | "2026-02-09T00:00:00.000Z" |
| user_invocable | true |
| invocation_hint | /github-issue |
| arguments | Required: Description of the issue to create
Example: /github-issue profile stats text wrapping bug
Example: /github-issue add video download feature
If no argument is provided, ask the user what issue they want to create.
|
GitHub Issue Creation Skill
Purpose
Help create well-structured GitHub issues that follow the project's hierarchy,
conventions, and existing templates from .github/ISSUE_TEMPLATE/.
Issue Hierarchy
Epic (large initiative, multiple features)
└── Feature (user-facing capability, multiple tasks)
└── Task (single unit of work)
└── Bug (defect to fix)
When to Use Each Type
| Type | Title Prefix | Use When |
|---|
| Epic | epic: | Large initiative spanning weeks/months |
| Feature | feat: | New user-facing capability |
| Task | task: | Single unit of implementation work |
| Bug | fix: | Something is broken/not working as expected |
Issue Templates
Bug Template (matches .github/ISSUE_TEMPLATE/bug_report.yaml)
Title format: fix: <description>
## Summary
[One sentence about what's broken]
## Environment
- App version: [e.g., 1.2.3]
- Device: [e.g., iPhone 14 Pro, iOS 17.1]
- Network: [WiFi / Cellular]
## Steps to Reproduce
1. Go to '...'
2. Click on '...'
3. See error
## Actual Result
[What actually happened]
## Expected Result
[What you expected to happen]
## Regression?
[Yes / No / Unknown - Did this work in a previous version?]
## Evidence
[Screenshots, screen recordings, logs, crash reports]
Feature Template (matches .github/ISSUE_TEMPLATE/feature_request.yaml)
Title format: feat: <description>
[Describe the feature or improvement]
[What problem does this solve or what does it make easier?]
[Describe a situation where you'd need this feature]
[Screenshots, mockups, examples from other apps]
