issues

name	issues
description	Interact with GitHub issues - create, list, and view issues.
type	skill
created	2026-02-27T00:00:00.000Z
domain	software-development
category	devtools
risk	unknown
source	community
tags	["skill","software-development","devtools","issues"]

Interact with GitHub issues - create, list, and view issues.

When to Use

• The user wants to create, list, inspect, or otherwise work with GitHub issues.
• The task involves issue intake or repository issue management through the GitHub CLI workflow.
• You need a guided issue flow that gathers titles, descriptions, and action selection before running commands.

Instructions

This command helps you work with GitHub issues using the gh CLI.

Step 1: Determine Action

Use AskUserQuestion to ask what the user wants to do:

Question:

• question: "What would you like to do with GitHub issues?"
• header: "Action"
• multiSelect: false
• options:
  • label: "Create new issue" description: "Open a new issue with title, body, and optional labels"
  • label: "List issues" description: "View open issues in the current repository"
  • label: "View issue" description: "See details of a specific issue by number"

---

If "Create new issue" selected:

Step 2a: Get Issue Title

Use AskUserQuestion to get the issue title:

Question:

• question: "What's a short, scannable title for this issue? Keep it brief (5-10 words max) - details go in the body. (Use 'Other' to type your title)"
• header: "Title"
• multiSelect: false
• options:
  • label: "I'll type a title" description: "Enter a concise title like 'Login button unresponsive' or 'Add dark mode support'"

Title guidelines:

• Keep titles SHORT and scannable (5-10 words max)
• Good: "Fix broken password reset flow"
• Bad: "When I try to reset my password and click the button nothing happens and I get an error"
• The description/body is where details belong, not the title

If the user provides a long title, help them shorten it and move the details to the body.

Step 3a: Get Issue Body

Use AskUserQuestion to gather the issue body content:

Question 1 - Issue type context:

• question: "What type of issue is this?"
• header: "Type"
• multiSelect: false
• options:
  • label: "Bug" description: "Something broken that needs fixing"
  • label: "Enhancement" description: "Improvement to existing functionality"
  • label: "New feature" description: "Brand new functionality"