github-issue-query

Query GitHub issues via gh CLI with optional jq filtering.

Updated Feb 26, 2026
One-click install
npx skills add https://github.com/kaushal-waygood/agentic-self-healing-ci --skill github-issue-query-kaushal-waygood
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: github-issue-query
Source: https://github.com/kaushal-waygood/agentic-self-healing-ci/tree/main/skills/github-issue-query
Command: npx skills add https://github.com/kaushal-waygood/agentic-self-healing-ci --skill github-issue-query-kaushal-waygood

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, jq.

What problem does it solve?

This skill enables efficient retrieval and filtering of GitHub issues from a repository by leveraging the GitHub CLI and optional jq expressions, reducing noise and enabling targeted data views.

Core Features & Use Cases

  • Query issues from a repository using gh with structured JSON output and optional jq-based filtering to transform results.
  • When --jq is provided, apply powerful, in-line filters and projections; when omitted, return a schema overview plus data size to gauge result scope.
  • Works against the current repository or a specified owner/repo, supporting common filters such as state, labels, assignees, and pagination-ready limits.

Quick Start

Run the script with a repository and a jq expression to filter and format the resulting issues.

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 from a repository and filter the JSON output?

To query GitHub issues and filter JSON output, use a shell script leveraging the GitHub CLI (gh) with optional jq expressions to transform and format the resulting data. This method returns schema information when no jq is provided and full data when jq is supplied.

Do I need the GitHub CLI and jq installed to query issues with custom filters?

Yes, you need both the GitHub CLI (gh) and jq installed to query issues with custom filters. The gh CLI retrieves the structured JSON output from the repository, while jq applies the in-line filters and projections to transform the results.

What happens when I query GitHub issues without providing a jq expression?

When you query GitHub issues without providing a jq expression, the script returns a schema overview plus the data size. This allows you to gauge the result scope and understand the available fields before applying targeted jq-based filtering.

Can I query GitHub issues from a specific owner/repo instead of the current repository?

Yes, you can query GitHub issues from a specific owner/repo instead of the current repository. The script supports querying the current repository by default or allowing you to specify a different owner/repo to retrieve issues with common filters like state, labels, and assignees.

What is the best way to reduce noise when retrieving large sets of GitHub issues?

The best way to reduce noise when retrieving large sets of GitHub issues is by applying jq-based filters to the gh CLI output. This enables targeted data views and powerful in-line projections, returning only the specific fields and issues you need.