Issue Skill

Issue operations for GitLab using the glab CLI.

Quick Reference

Risk Legend: - Safe | ⚠️ Caution | ⚠️⚠️ Warning | ⚠️⚠️⚠️ Danger

When to Use This Skill

ALWAYS use when:

• User wants to work with issues
• User mentions "issue", "bug", "task", "ticket" or related terms
• User wants to track or manage work items

NEVER use when:

• User wants bulk operations on 10+ issues (use gitlab-bulk instead)
• User is only searching/filtering issues (use gitlab-search instead)

Available Commands

List Issues

glab issue list [options]

Options:

Examples:

# List all open issues
glab issue list

# List issues assigned to you
glab issue list --assignee=@me

# List closed issues
glab issue list --closed

# List issues with specific label
glab issue list --label=bug

# List issues in a milestone
glab issue list --milestone="Release 1.0"

# Search issues
glab issue list --search="login bug"

# Get all issues (paginated)
glab issue list --all

View Issue Details

glab issue view <id> [options]

Options:

Examples:

# View issue in terminal
glab issue view 42

# Open issue in browser
glab issue view 42 --web

# View with comments
glab issue view 42 --comments

Create Issue

glab issue create [options]

Options:

Examples:

# Create issue with title
glab issue create -t "Fix login bug"

# Create issue with full details
glab issue create -t "Add dark mode" -d "Implement dark mode toggle" -l "enhancement,ui"

# Create issue with milestone and assignee
glab issue create -t "Release prep" -m "Release 2.0" -a "@me"

# Create confidential issue
glab issue create -t "Security vulnerability" --confidential

# Create and open in browser
glab issue create -t "New feature" --web

Update Issue

glab issue update <id> [options]

Options:

Examples:

# Update title
glab issue update 42 -t "Updated title"

# Add labels
glab issue update 42 -l "priority,reviewed"

# Remove labels
glab issue update 42 --unlabel="needs-review"

# Change assignee
glab issue update 42 -a "username"

# Add to milestone
glab issue update 42 -m "Sprint 5"

Close/Reopen Issue

# Close issue
glab issue close <id>

# Reopen issue
glab issue reopen <id>

Delete Issue

glab issue delete <id>

Warning: This permanently deletes the issue. Use with caution.

Add Note/Comment

glab issue note <id> -m "<message>"

Examples:

# Add comment
glab issue note 42 -m "Working on this now"

# Add closing comment
glab issue note 42 -m "Fixed in !123"

Subscribe/Unsubscribe

# Subscribe to issue notifications
glab issue subscribe <id>

# Unsubscribe
glab issue unsubscribe <id>

Common Workflows

Workflow 1: Triage Issues

# 1. List unassigned issues
glab issue list --assignee=""

# 2. View issue details
glab issue view 42

# 3. Assign and label
glab issue update 42 -a "developer" -l "bug,priority"

Workflow 2: Work on Issue

# 1. Find assigned issues
glab issue list --assignee=@me

# 2. View details
glab issue view 42

# 3. Create branch and work
git checkout -b fix/issue-42

# 4. Add progress note
glab issue note 42 -m "Started work on this"

# 5. Close when MR is merged
glab issue close 42

Workflow 3: Quick Bug Report

# Create issue with all details
glab issue create \
  -t "Login fails with special characters" \
  -d "Steps to reproduce:
1. Enter username with @ symbol
2. Click login
3. Error: 500

Expected: Login succeeds" \
  -l "bug,login"

Troubleshooting

Related Documentation

• Safeguards
• Quick Reference