github-issue-query

Official

Filter GitHub issues with powerful `jq` queries.

Authorgithubnext
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill streamlines the process of querying GitHub issues by providing efficient jq filtering support, allowing users to quickly retrieve, filter, and transform issue data for analysis or further automation. It helps AI agents and developers automate data collection and analysis from GitHub.

Core Features & Use Cases

  • Flexible Querying: List issues from the current or any specified repository with options for state (open, closed, all) and limit.
  • Advanced jq Filtering: Use jq expressions to filter by author, labels, comments, creation date, and transform output to desired formats.
  • Schema & Size Information: Get schema and data size details when no jq filter is provided, preventing overwhelming responses.
  • Automated Data Extraction: Ideal for AI agents needing specific issue data for decision-making or reporting.
  • Use Case: An AI agent needs to find all open issues labeled "bug" that have more than 5 comments. This skill enables the agent to execute a query-issues.sh --jq '.[] | select(.state == "OPEN" and (.labels | map(.name) | index("bug")) and .comments.totalCount > 5)' command.

Quick Start

Use the github-issue-query skill to list the number and title of all open issues in the current repository: ./query-issues.sh --jq '.[] | {number, title}'.

Dependency Matrix

Required Modules

None required

Components

scripts

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: github-issue-query
Download link: https://github.com/githubnext/gh-aw/archive/main.zip#github-issue-query

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository