Issue Management

Issue Management

Comprehensive GitHub issue lifecycle management with templates, metadata, and intelligent context detection.

Purpose

Issue Management provides explicit control over GitHub issue operations. While hooks automatically create issues on first prompt, this skill allows users to directly manage issue creation, updates, labeling, assignment, and linking with full control over templates and metadata.

When to Use

• Creating issues with specific templates (bug/feature/epic/task)
• Updating existing issue metadata (labels, assignees, milestones)
• Linking issues as parent-child or related
• Searching and filtering issues
• When hooks don't fit the workflow (e.g., creating multiple issues at once)

Core Capabilities

Issue Creation

Create issues using structured templates:

# Bug report with template
gh issue create --title "Auth fails on Safari" --body "$(cat <<'EOF'
## Bug Description

Authentication fails silently on Safari 17.2

## Steps to Reproduce

1. Open Safari 17.2
2. Navigate to /login
3. Enter credentials
4. Click Sign In

## Expected Behavior

User should be redirected to dashboard

## Actual Behavior

Page reloads with no error message

## Environment

- OS: macOS 14.2
- Browser: Safari 17.2
- Version: v1.5.0
EOF
)"

Available Templates:

• getBugTemplate() - Bug report with repro steps
• getFeatureTemplate() - Feature request with problem statement
• getEpicTemplate() - Epic with subtasks checklist
• getTaskTemplate() - Simple task with acceptance criteria

Utilities:

• renderTemplate(template, vars) - Substitute {{varName}} placeholders
• getMinimalIssueBody(description, context?) - Basic issue without template

Issue Updates

Update issue metadata after creation:

# Add labels
gh issue edit 42 --add-label "bug,priority:high"

# Assign users
gh issue edit 42 --add-assignee @me,@username

# Update milestone
gh issue edit 42 --milestone "v2.0"

# Update body
gh issue edit 42 --body-file updated-description.md