# Pr Summary

> Summarize accessible open GitHub pull requests from structured gh JSON, filtering bots and grouping results by ticket. Use for a read-only PR status report. Not for: changing PR state, reviewing code, merging, or closing PRs. Output: grouped Markdown written to /tmp/pr-summary.md and displayed for copying.

- Skill: `hmj1026/pr-summary` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx get-skill add hmj1026/pr-summary`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hmj1026/pr-summary/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: hmj1026 (https://skillmd.com/u/hmj1026)
- Updated: 2026-11-16
- Page: https://skillmd.com/skills/hmj1026/pr-summary

---


# PR Summary

## Workflow

Run in the consumer repository and preserve `--author <user>` and
`--label <label>`. Resolve the repository with `gh repo view`, then query open
PRs with `gh pr list --json ...`; consume structured JSON rather than scraping
terminal formatting. Stop when `gh` is unavailable, the repository query
fails, or the PR query fails.

Filter bot-authored PRs, group the remaining records by ticket ID (including
stacked PR annotations), format the report, write the same report to
`/tmp/pr-summary.md`, and display it with copy instructions. The exact JSON
fields and grouping rules are in
[`references/workflow.md`](references/workflow.md). This workflow never
changes GitHub state.

## When NOT to Use

- A PR must be created, edited, merged, closed, or labeled.
- A code review or merge-readiness verdict is requested.
- `gh` repository credentials or access are unavailable.

## Output

Formatted open-PR groups with ticket IDs and stacked-PR annotations, plus the
path `/tmp/pr-summary.md` and copy instructions. An empty result is a valid
report. Query or report-write failures are terminal `UNAVAILABLE`/`FAIL`
results and must be surfaced.

## Verification

- [ ] Repository and PR data came from successful structured `gh` JSON calls.
- [ ] `--author`/`--label` filters were preserved and bot PRs were handled.
- [ ] Every included PR appears in exactly one ticket group (or an explicit
      `unassigned` group).
- [ ] `/tmp/pr-summary.md` exists and matches the displayed report.

## References

- [`references/workflow.md`](references/workflow.md) — `gh` fields, filters,
  bot exclusion, ticket grouping, and report format.

