github-pr-query

Query GitHub pull requests with optional jq filtering for structured JSON output.

Updated Feb 18, 2026
One-click install
npx skills add https://github.com/az9713/gh-aw --skill github-pr-query-az9713
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: github-pr-query
Source: https://github.com/az9713/gh-aw/tree/main/skills/github-pr-query
Command: npx skills add https://github.com/az9713/gh-aw --skill github-pr-query-az9713

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Query GitHub pull requests data efficiently by combining native gh CLI output with jq-based filtering, enabling fast, precise PR insights.

Core Features & Use Cases

  • Query PRs from the current repository or a specified repository.
  • Optional jq filtering to transform and extract specific fields.
  • When --jq is omitted, returns a schema/size overview to help understand the data shape.

Quick Start

Run the query-prs script to fetch PRs for the current repo, then refine results with --jq to tailor output.

Frequently Asked Questions about github-pr-query

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

FAQPage Schema
How do I query GitHub pull requests and filter specific fields?

Query GitHub pull requests and filter fields by running the query-prs script with the --jq option to apply jq-based filtering and extract a structured JSON dataset. Omitting --jq returns a schema and size overview instead.

Do I need the GitHub CLI installed to fetch pull request data?

Yes, fetching pull request data requires the GitHub CLI (gh) and jq to be installed, as the script combines native gh CLI output with jq-based filtering to return structured PR information.

Can I query pull requests from a specific GitHub repository?

Yes, you can query pull requests from a specific GitHub repository by using the --repo option, otherwise the script targets the current repository by default to extract PR data.

What GitHub pull request fields are extracted by default?

The script extracts pull request fields including number, title, state, author, and URLs. You can use --jq to refine this output and return a filtered JSON dataset tailored to your needs.

How do I limit the number of pull requests returned from a GitHub query?

You can limit the number of pull requests returned by using the --limit option alongside --repo and --state to control the volume of PR data extracted from GitHub.

Why does my pull request query return a schema overview instead of filtered data?

Your pull request query returns a schema and size overview when the --jq option is omitted. Provide a valid jq filter with --jq to transform the output and return a filtered JSON dataset.