github-issue
GitHub issue lifecycle management with worktree isolation
When & Why to Use This Skill
This Claude skill provides a comprehensive automation suite for managing the GitHub issue lifecycle, from initial triage to code implementation and pull request creation. By leveraging git worktree isolation, it enables developers to implement fixes and features in clean, independent environments, significantly reducing context-switching overhead and preventing local workspace pollution.
Use Cases
- Automated Bug Resolution: Streamline the entire process of fetching a GitHub issue, creating an isolated worktree, implementing the fix, and submitting a pull request automatically.
- Efficient Issue Management: List, create, and update GitHub issues directly through the AI agent to maintain project momentum without leaving the development context.
- Isolated Feature Implementation: Use the fix workflow to develop new features in dedicated worktrees, ensuring the main development branch remains stable and the environment stays organized.
- Rapid PR Creation: Automatically handle the commit, push, and pull request submission process after code changes are verified, ensuring consistent contribution workflows.
| name | github-issue |
|---|---|
| version | 0.7.0 |
| description | GitHub issue lifecycle management with worktree isolation |
| entry_point | /github-issue |
GitHub Issue Lifecycle Skill
Manage GitHub issues from listing to fixing to PR creation with clean worktree isolation.
Commands
/github-issue- Main entry point for all issue operations
Agents
issue-intake-agent- List and fetch issue detailsissue-mutate-agent- Create and update issuesissue-fix-agent- Implement fixes in isolated worktreesissue-pr-agent- Create pull requests
Operations
--list [--repo owner/repo]- List open issues--create- Create issue interactively--update <id>- Update issue fields--fix --issue <id/url> [--yolo]- Full fix workflow: fetch → confirm → worktree → implement → test → commit → push → PR
Dependencies
- Skills: sc-managing-worktrees (worktree operations)
- CLI: GitHub CLI (
gh) required - Config:
.claude/config.yaml(base_branch, worktree_root, github settings)
Configuration
base_branch: main
worktree_root: ../worktrees
github:
branch_pattern: "fix-issue-{number}"
Data Contracts
All agents return fenced JSON:
{
"success": true|false,
"data": { /* operation results */ },
"error": null|"message"
}
Safety
- Pre-flight
ghCLI auth checks - Approval gates before destructive ops (unless
--yolo) - Test failure prompts
- Actionable error messages
References
.claude/references/github-issue-apis.md- GitHub CLI patterns.claude/references/github-issue-checklists.md- Workflow checklists