github-issue-query

Query GitHub issues with jq filters via the gh CLI.

4.9k|489|Updated Aug 12, 2025
One-click install
npx skills add https://github.com/github/gh-aw --skill github-issue-query-github
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: github-issue-query
Source: https://github.com/github/gh-aw/tree/main/skills/github-issue-query
Command: npx skills add https://github.com/github/gh-aw --skill github-issue-query-github

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, jq, and includes scripts (resource) components.

What problem does it solve?

This skill enables efficient querying of GitHub issues by leveraging jq filters to extract targeted data, reducing manual data collection and post-processing.

Core Features & Use Cases

  • jq-powered querying: fetch issues from the current or a specified repository with precise, flexible filters.
  • Schema-first insight: when no jq expression is provided, returns the data schema and approximate size to help plan queries.
  • Real-world scenarios: quickly identify open issues, filter by labels or assignees, or extract concise summaries across a repo.

Quick Start

Use the script to list issues with default parameters: ./query-issues.sh To apply targeted filtering, provide a jq expression: ./query-issues.sh --jq '.[] | {number, title, state}'

Frequently Asked Questions about github-issue-query

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I query GitHub issues with jq filters?

To query GitHub issues with jq filters, use a script that passes the `--jq` flag to extract targeted fields like `.[] | {number, title, state}` from the fetched repository data. You can run it with default parameters or specify a repository.

Do I need gh and jq installed to query GitHub issues?

Yes, you need both the `gh` CLI and `jq` installed to query GitHub issues. The skill relies on `gh` to fetch repository issues and `jq` to parse and filter the returned JSON data.

What's the best way to see the data schema before filtering GitHub issues?

The best way to see the data schema before filtering GitHub issues is to run the query script without providing a jq expression. This returns a schema-only view and approximate size, helping you plan your targeted filters.

Can I query GitHub issues from a specific repository?

Yes, you can query GitHub issues from a specific repository by using the `--repo` option. This allows you to define a specific owner and repository, or it defaults to querying the current repository.

How do I filter open GitHub issues by state and limit results?

To filter open GitHub issues by state and limit results, use the `--state` and `--limit` options. Combine these with a `--jq` expression to precisely control the query scope and extract concise summaries across the repository.