Agent Skills: List Pull Requests

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.

UncategorizedID: rlcurrall/aide/pr-list

Install this agent skill to your local

pnpm dlx add-skill https://github.com/rlcurrall/aide/tree/HEAD/skills/pr-list

Skill Files

Browse the full folder contents for pr-list.

Download Skill

Loading file tree…

skills/pr-list/SKILL.md

Skill Metadata

Name
pr-list
Description
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.

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

  1. PR number and title
  2. Status (active, completed, abandoned)
  3. Creation date
  4. Author name
  5. 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-by to quickly find your own PRs
  • Use --format json when processing results programmatically
  • Set --limit higher 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