github-issue

GitHub issue lifecycle management with worktree isolation

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026

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.
namegithub-issue
version0.7.0
descriptionGitHub 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 details
  • issue-mutate-agent - Create and update issues
  • issue-fix-agent - Implement fixes in isolated worktrees
  • issue-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 gh CLI 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