name: pr-summary
description: "List open PRs, filter automation PRs, group by ticket ID, format as Markdown. Use when: user asks for PR summary, PR status, or /pr-summary"
allowed-tools: Bash(git:), Bash(gh:), Bash(bash:*)
PR Summary
List open PRs, filter automation PRs (dependabot/snyk), group by ticket ID, output formatted summary.
When NOT to Use
| Scenario |
Use Instead |
| Create a new PR |
/create-pr |
| Review PR code |
/codex-review |
| View single PR details |
gh pr view <N> |
| Pre-merge analysis |
/merge-prep |
Input
/pr-summary [--author <user>] [--label <label>]
| Argument |
Description |
Default |
--author <user> |
Filter by author |
All |
--label <label> |
Filter by label |
All |
Workflow
1. Run Script
bash skills/pr-summary/scripts/pr-summary.sh [--author <user>] [--label <label>]
The script automatically:
| Step |
Action |
| Fetch |
gh pr list --json to get open PRs (max 200) |
| Filter |
Exclude dependabot/* and snyk-* |
| Group |
Group by ticket ID ({TICKET_PATTERN} or [A-Z]+-\d+) |
| Detect |
Identify stacked PRs (base is not main/master/develop) |
| Output |
Write formatted text to /tmp/pr-summary.md |
2. Display Results
Read /tmp/pr-summary.md and display to user.
3. Provide Copy Instructions
Content written to /tmp/pr-summary.md
Copy: cat /tmp/pr-summary.md | pbcopy
Output Format
Markdown (default)
**PROJ-520**
https://github.com/user/repo/pull/123
> fix: Add Redis cache for contract codes
https://github.com/user/repo/pull/124
> fix: Tune server timeouts (stacked on fix/PROJ-520)
**PROJ-123**
https://github.com/user/repo/pull/99
> feat: Add DeFi portfolio tracking
Grouping Rules
| Condition |
Strategy |
| Same ticket ID |
Same group |
| Stacked PR (base is feature branch) |
Same group, annotate (stacked on <base>) |
| No ticket / unrelated |
Standalone entry |
Filter Rules
| PR Source |
Action |
dependabot/* |
Exclude |
snyk-* |
Exclude |
| Others |
Keep |
References
| File |
Purpose |
| pr-summary.sh |
PR fetch, filter, group, format script |
Verification
By