How do I filter by multiple labels?

Use repeated -l/--label flags, for example gh issue list -l bug -l priority.

How do I export results for scripting?

Pass --json with the desired fields and pipe to jq for formatting.

Can I open results in a browser?

Yes, use --web to launch the default browser.

gh-issue-list

npx machina-cli add skill dceoy/github-cli-agent-skills/gh-issue-list --openclaw

Files (1)

SKILL.md

2.6 KB

GitHub Issue List

When to use

The user asks to list issues in a repository.
Finding issues by author, label, milestone, or state.
Reviewing issue backlog or triaging.

Inputs to confirm

Filter criteria: state (open/closed/all), author, assignee, labels, milestone.
Search query if advanced filtering needed.
Target repo if not current (--repo OWNER/REPO).
Output format (table, JSON, web).

Workflow

Verify auth:
```
gh --version
gh auth status
```

List issues with filters:

gh issue list
gh issue list --state all --limit 50
gh issue list --author "@me"
gh issue list --label "bug" --label "priority"
gh issue list --assignee "@me" --state open
gh issue list --milestone "v2.0"

Use search syntax for advanced queries:

gh issue list --search "no:assignee sort:created-asc"
gh issue list --search "is:open label:bug -label:wontfix"

Get JSON output for scripting:

gh issue list --json number,title,state,labels --jq '.[] | "\(.number): \(.title)"'

Examples

# List your assigned issues
gh issue list --assignee "@me"

# Find unassigned bugs
gh issue list --label "bug" --search "no:assignee"

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

# Get issues as JSON
gh issue list --json number,title,state,assignees

# Open issue list in browser
gh issue list --web

Flags reference

Flag	Description
`-s, --state`	Filter: open, closed, all (default: open)
`-A, --author`	Filter by author
`-a, --assignee`	Filter by assignee
`-l, --label`	Filter by label (repeatable)
`-m, --milestone`	Filter by milestone name or number
`--mention`	Filter by mentioned user
`-S, --search`	Search with GitHub query syntax
`-L, --limit`	Max items to fetch (default 30)
`--json`	Output specific fields as JSON
`-w, --web`	Open list in browser

References

GitHub CLI manual: https://cli.github.com/manual/
Search syntax: https://docs.github.com/en/search-github/searching-on-github/searching-issues-and-pull-requests
gh issue list --help

Source

git clone https://github.com/dceoy/github-cli-agent-skills/blob/main/skills/gh-issue-list/SKILL.mdView on GitHub

Overview

gh-issue-list enables listing GitHub issues from a repository using the gh CLI with filters such as state, author, assignee, labels, and milestone. It supports advanced search queries and JSON output for scripting, and can open results in a browser for quick review. This makes backlog triage and reporting faster and more repeatable.

How This Skill Works

It constructs a gh issue list command by combining filters like --state, --author, --assignee, --label, and --milestone, with optional --search for GitHub query syntax. You can request specific fields with --json and format results with jq, or open the results in a browser with --web. If the target repo is not the current one, include --repo OWNER/REPO.

When to Use It

You need to list issues in a repository
Filter by state, author, assignee, labels, or milestone
Perform advanced filtering with --search
Export data for scripting with --json
Open results quickly in a browser with --web

Quick Start

Step 1: Verify auth with gh --version and gh auth status
Step 2: List issues using filters such as --state open or --label bug
Step 3: Output as JSON with --json or open in a browser with --web

Best Practices

Specify the target repo with --repo if not in the current directory
Choose only the JSON fields you need with --json
Combine filters to narrow results rather than broad queries
Use --limit to cap results and improve performance
Blend --search with label and milestone filters for precise results

Example Use Cases

gh issue list --assignee "@me"
gh issue list --label "bug" --search "no:assignee"
gh issue list --milestone Release 1.0
gh issue list --json number,title,state,assignees
gh issue list --web

Frequently Asked Questions

Add this skill to your agents