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}'.