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