Skip to content
issues logo

List GitHub Issues

issues

List and filter GitHub issues

SKILL.md

Full skill instructions

List GitHub Issues

Display open issues with optional filtering.

Usage

/​issues              # List all open issues
/​issues bug          # Filter by label
/​issues feature      # Filter by feature label
/​issues milestone:v1.0  # Filter by milestone

Steps

1. Parse Arguments

If argument provided:

  • Check if it's a milestone filter (contains "milestone:")
  • Otherwise treat as label filter

2. List Issues

# Default: list all open issues
gh issue list --limit 50

# With label filter
gh issue list --label "bug" --limit 50

# With milestone filter
gh issue list --milestone "v1.0" --limit 50

3. Format Output

Display in readable format with:

  • Issue number
  • Type label (bug/​feature/​task)
  • Title
  • Additional labels in parentheses

Example Output

#42  [bug] Racer teleports through walls           (play-test-found, collision-detection)
#38  [feature] Add AI opponent                     (game-logic, ai)
#35  [task] Refactor collision detection           (collision-detection)

3 open issues

Filter Examples

/​issues bug                    # Only bugs
/​issues feature                # Only features
/​issues play-test-found        # Auto-discovered bugs
/​issues collision-detection    # Collision issues
/​issues milestone:v1.0         # Issues in v1.0 milestone

Notes

  • Uses GitHub CLI (gh) which requires authentication
  • Shows open issues by default
  • For closed issues, users can run: gh issue list --state closed
  • Labels are color-coded in terminal output