pr-summary

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

• Lists all open PRs (excluding dependabot/snyk)
• PRs grouped by ticket ID
• Stacked PRs annotated with dependency
• Output format is valid Markdown
• /tmp/pr-summary.md written