# PR List

> PR List is an Agent Skill for productivity published in the gastownhall/gastown repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

List GitHub PRs in a formatted ASCII table. Supports filters like --state, --author, --label. Use for PR review workflows and sheriff duties.

- Skill name: `pr-list`
- Category: [Productivity](https://www.openparable.com/skill/productivity/1)
- Source: https://github.com/gastownhall/gastown/blob/HEAD/.claude/skills/pr-list/SKILL.md
- Repository: gastownhall/gastown (17,044 GitHub stars when collected)

## SKILL.md

# PR List - Formatted Pull Request Table

Display GitHub pull requests in a clean ASCII box-drawing table format.

## Usage

```
/pr-list [options]
```

## Options (passed to gh pr list)

- `--state open|closed|merged|all` - Filter by state (default: open)
- `--author <user>` - Filter by author
- `--label <label>` - Filter by label (can repeat)
- `--limit <n>` - Max items to fetch (default: 30)
- `--assignee <user>` - Filter by assignee
- `--draft` - Show only drafts
- `--all-reviews` - Include PRs with CHANGES_REQUESTED (excluded by default)

## Execution Steps

1. Run `gh pr list` with any provided options plus `--json number,author,title,state,isDraft,reviewDecision`
2. **Filter out PRs with reviewDecision="CHANGES_REQUESTED"** (unless `--all-reviews` specified)
3. Format output as an ASCII table using box-drawing characters
4. Truncate titles to fit reasonable terminal width (~50 chars)
5. Truncate author names if needed (~18 chars)
6. Show state as OPEN/CLOSED/MERGED/DRAFT, append "(changes requested)" if filtered with --all-reviews

## Output Format

Use this exact table style with box-drawing characters:

```
┌─────┬────────────────────┬───────────────────────────────────────────────────┬────────┐
│  PR │ Author             │ Title                                             │ State  │
├─────┼────────────────────┼───────────────────────────────────────────────────┼────────┤
│ 123 │ username           │ feat: add new feature for something               │ OPEN   │
│ 122 │ another-user       │ fix: resolve bug in component                     │ DRAFT  │
└─────┴────────────────────┴───────────────────────────────────────────────────┴────────┘
```

## Table Requirements

- Use Unicode box-drawing: `┌ ┐ └ ┘ ├ ┤ ┬ ┴ ┼ │ ─`
- Right-align PR numbers
- Left-align text columns
- Pad columns consistently
- Show count summary below table: "**N open PRs** (M drafts)"

## Example Commands

```bash
# Default - open PRs (excludes CHANGES_REQUESTED)
gh pr list --json number,author,title,state,isDraft,reviewDecision

# With filters
gh pr list --state all --author boshu2 --json number,author,title,state,isDraft,reviewDecision
```

---

Source: https://www.openparable.com/skill/productivity/pr-list (OpenParable). Cite the canonical URL above.