Agent skill
pr-list
List pull requests from the repository. Use when the user wants to see open PRs, find PRs to review, check their own PRs, or browse PR history.
Install this agent skill to your Project
npx add-skill https://github.com/rlcurrall/aide/tree/main/skills/pr-list
SKILL.md
List Pull Requests
List pull requests from the repository with filtering options.
When to Use
- User asks "what PRs are open?" or "show me the PRs"
- User wants to find PRs to review
- User wants to check their own open PRs
- User wants to browse completed/merged PRs
How to Execute
Run:
aide pr list [options]
Flags
| Flag | Description |
|---|---|
--status |
Filter by status: active, completed, abandoned, all (default: active) |
--limit |
Maximum number of PRs to return (default: 20) |
--created-by |
Filter by creator email or display name |
--author |
Alias for --created-by |
--project |
Project name (auto-discovered from git remote) |
--repo |
Repository name (auto-discovered from git remote) |
--format |
Output format: text, json, markdown |
Output Includes
- PR number and title
- Status (active, completed, abandoned)
- Creation date
- Author name
- Description preview
Common Patterns
# List active PRs (default)
aide pr list
# List all PRs regardless of status
aide pr list --status all
# List completed (merged) PRs
aide pr list --status completed
# List your own PRs
aide pr list --created-by "your.email@company.com"
# Combine filters
aide pr list --status active --created-by "john.doe" --limit 10
# Output as JSON for processing
aide pr list --format json
Use Cases
| Goal | Command |
|---|---|
| Find PRs to review | aide pr list --status active |
| Track your work | aide pr list --created-by "me@company.com" |
| Audit merged changes | aide pr list --status completed --limit 50 |
| Monitor team activity | aide pr list --status all |
Best Practices
- Use
--status active(default) for day-to-day review work - Use
--created-byto quickly find your own PRs - Use
--format jsonwhen processing results programmatically - Set
--limithigher when searching for specific PRs
Next Steps
After listing PRs:
- Use pr-view skill to see details of a specific PR
- Use pr-comments skill to check feedback on a PR
- Use pr-diff skill to review code changes
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
release
Create a new software release by bumping version numbers, committing changes, creating git tags, and pushing to remote. Use when creating a release, bumping versions, or publishing a new version.
ticket-attach
Manage Jira ticket attachments. Use when the user wants to list, upload, download, or delete attachments on a ticket.
pr-comments
Load PR comments and feedback for code review. Use when the user wants to see reviewer feedback, check for unresolved comments, understand what changes are requested, or review discussion on a PR.
ticket-update
Update fields on an existing Jira ticket. Use when the user wants to modify a ticket's summary, description, assignee, priority, labels, or custom fields.
pr-create
Create a new pull request. Use when the user wants to open a PR, submit code for review, create a draft PR, or push changes for merge.
ticket-transition
Change a Jira ticket's workflow status. Use when the user wants to move a ticket to a different status, start work, complete a task, or change workflow state.
Didn't find tool you were looking for?