github-pr-query

What problem does it solve?

This Skill streamlines the process of querying GitHub pull requests by providing efficient jq filtering support, allowing users to quickly retrieve, filter, and transform PR 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 PRs from the current or any specified repository with options for state (open, closed, merged, all) and limit.
• Advanced jq Filtering: Use jq expressions to filter by author, labels, changed files, review decisions, 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 PR data for decision-making or reporting.
• Use Case: An AI agent needs to find all open pull requests with more than 10 changed files that are awaiting review. This skill enables the agent to execute a query-prs.sh --jq '.[] | select(.state == "open" and .changedFiles > 10 and .reviewDecision == "REVIEW_REQUIRED")' command.

Quick Start

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