gh-issues

---

name: gh-issues description: Use when creating, listing, or viewing GitHub issues via CLI - triggers on issue management tasks, bug reporting, or feature requests

Create, list, or view GitHub issues using the gh CLI.

Decision Flow

Copydigraph {
  rankdir=TB
  "User invokes gh-issues" -> "Ask: Create, List, or View?"
  "Ask: Create, List, or View?" -> "Create" [label="new issue"]
  "Ask: Create, List, or View?" -> "List" [label="browse"]
  "Ask: Create, List, or View?" -> "View" [label="specific #"]
  "Create" -> "Get title (5-10 words)"
  "Get title (5-10 words)" -> "Get type + description"
  "Get type + description" -> "Bug?" [shape=diamond]
  "Bug?" -> "Ask repro steps + expected/actual" [label="yes"]
  "Bug?" -> "Optional labels" [label="no"]
  "Ask repro steps + expected/actual" -> "Optional labels"
  "Optional labels" -> "gh issue create"
  "List" -> "Ask filter (all/assigned/author/label)"
  "Ask filter (all/assigned/author/label)" -> "gh issue list"
  "View" -> "Ask issue number"
  "Ask issue number" -> "gh issue view"
}

Quick Reference

Workflow

Step 1: Ask Action

Use AskUserQuestion with options: Create new issue, List issues, View issue

Create Flow

1. Get title - Ask via AskUserQuestion. Enforce 5-10 words max. If user provides long title, shorten it and move details to body.
2. Get type - Bug / Enhancement / Feature / Task
3. Get description - Full details via "Other" input
4. If Bug: Ask for repro steps + expected vs actual behavior
5. Optional labels - multiSelect: bug, enhancement, documentation, good first issue
6. Create with HEREDOC:

Copygh issue create --title "Title" --body "$(cat <<'EOF'
## Description
[description]

## Steps to Reproduce  # (bugs only)
[steps]

## Expected / Actual   # (bugs only)
[behavior]
EOF
)"

List Flow

Ask filter preference, then run appropriate command from Quick Reference table.

View Flow

Ask issue number, run gh issue view [number].

Common Mistakes

Error Handling

If gh fails: check gh auth status, verify GitHub remote exists, report specific error.