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.