name: issue
description: Create and update GitHub issues. Triggers on "create issue", "file issue", "open issue", "new issue", "report bug", "request feature", "track this", "create epic", "create theme", "update issue", "check off", "mark complete", "close issue", "verify issue", "verify #", "ralph-loop", "scan issues", "scan criteria", "view issue", "view #". Infers type, labels, and milestone from conversation context.
allowed-tools: Bash(gh:*), AskUserQuestion, Grep, Read, Edit, Write, TodoWrite
user-invocable: true
argument-hint: view [--comments] | verify [--all] [--dry-run] | ralph-loop [--max-iterations ] | scan [--milestone ] [--fix]
context: fork
Issue Skill
Create, update, and manage GitHub issues following ZeroAE conventions. Infer as much as possible from context; only ask when ambiguous.
Modes
| Mode | Trigger | Purpose |
|---|---|---|
| View | "view issue", "view #123", /issue view <number> |
Display issue summary |
| Create | "create issue", "file issue", "new issue", "report bug", "request feature" | Create new issue |
| Update | "update issue", "add to issue", "update #123" | Modify existing issue |
| Progress | "check off", "mark complete", "done with", "finished" | Check checkboxes based on work done |
| Verify | /issue verify <number> [--all] [--dry-run] |
Validate unchecked criteria, prompt to check off |
| Ralph Loop | /issue ralph-loop <number> [--max-iterations <n>] |
Iteratively work until all criteria pass |
| Scan | /issue scan [--milestone <name>] [--fix] |
Flag subjective acceptance criteria |
Mode Detection
-
If
viewkeyword (/issue view 135,view #135) → View mode -
If
ralph-loopkeyword (/issue ralph-loop 133) → Ralph Loop mode -
If
scankeyword (/issue scan,/issue scan --milestone v0.5.0) → Scan mode -
If
verifykeyword (/issue verify 150) → Verify mode - If update phrases ("update issue", "add to #123") → Update mode
- If progress phrases ("check off", "mark complete") → Progress mode
- Otherwise → Create mode
Supported Issue Types
GitHub supports 5 issue types. The title emoji can be any gitmoji:
| GitHub Type | Canonical Emoji | Alternative Emojis | Use For |
|---|---|---|---|
| Bug | 🐛 | 🔒 (security) | Defects, unexpected behavior |
| Feature | ✨ | ⚡ (perf), 💥 (breaking) | New functionality, enhancements |
| Task | 📋 | 📝 (docs), ✅ (test) | Documentation, testing, specific work items |
| Chore | 🔧 | ♻️ (refactor), ⬆️ (deps), 👷 (ci), 🔥 (remove) | Maintenance: refactor, deps, ci, cleanup |
| Epic | 🎯 | - | Major feature spanning multiple issues |
| Theme | 🎨 | - | Strategic initiative spanning epics |
See conventions.md for full gitmoji-to-type mapping.
Note: For release preparation, use
/pr release <version>to create a Release Prep PR.
Reference Files
- view.md - View issue mode
- create.md - Create issue mode
- update.md - Update issue mode
- progress.md - Progress tracking mode
- verify.md - Acceptance criteria verification mode
- ralph-loop.md - Ralph Loop mode (iterative issue resolution)
- scan.md - Scan mode (flag subjective acceptance criteria)
- templates.md - Issue body templates for each type
- conventions.md - Label taxonomy, title formatting, milestone rules
chat Comments (0)
Sign in to join the discussion and leave a comment.
Skill Details
GitHub Stars
0
GitHub Forks
0
Created
Jan 2026
Last Updated
5 months ago
tools
tools productivity tools
Related Skills
Build your own?
Join 12,000+ developers contributing to the Claude ecosystem.
No comments yet. Be the first to share your thoughts!