GitHub Skill

issue

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". Infers type, labels, and milestone from conversation context.

zeroae☆ 0 Repository stars0 Repository forks

View source ↗Installation

Installation

Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.

View source ↗Guides

Skill instructions

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 view keyword (/issue view 135, view #135) → View mode
If ralph-loop keyword (/issue ralph-loop 133) → Ralph Loop mode
If scan keyword (/issue scan, /issue scan --milestone v0.5.0) → Scan mode
If verify keyword (/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

Examples

Read the usage examples in the source repository.

View source ↗

Source history

Indexed on: 2026-01-20
Index updated: 2026-01-26
Branch: main

Index and sync dates describe this directory. View the source repository for code history.

GitHub ↗

chat Comments (0)

chat_bubble_outline

No comments yet. Be the first to share your thoughts!