Agent skill
pr-summary
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
Install this agent skill to your Project
npx add-skill https://github.com/sd0xdev/sd0x-dev-flow/tree/main/skills/pr-summary
SKILL.md
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.mdwritten
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
runbook
Generate and update feature release runbooks from existing docs and codebase. Use when: creating operational runbook, release handbook, deployment checklist, pre-release preparation. Not for: incident response (v2), code review (use codex-code-review), architecture design (use architecture).
ask
Context-aware Q&A with auto context gathering. Use when: user has a quick question about codebase, git history, rules, docs, or skills during development. Not for: code changes (use feature-dev), code review (use codex-review-fast), deep research (use deep-research), full code trace (use code-explore). Output: structured answer with source attribution.
project-brief
Convert a technical spec into a PM/CTO-readable executive summary. Simplify technical details, focus on business value.
codex-test-gen
Generate unit tests for specified functions using Codex MCP
bug-fix
Bug fix workflow. Use when: fixing bugs, resolving issues, regression fixes. Not for: new features (use feature-dev), understanding code (use code-explore). Output: fix + regression test + review gate.
skill-health-check
Validate skill quality against routing, progressive loading, and verification criteria. Use when: auditing skills, checking skill health, reviewing skill design. Not for: code review (use codex-code-review) or doc review (use doc-review). Output: health report with per-skill ratings + Gate.
Didn't find tool you were looking for?