pull-requestslisted
Install: claude install-skill app-vitals/shipwright
# Pull Requests — Skill
Use this skill to query PR records tracked by the Shipwright task store.
Results are fetched from `GET /prs` and displayed as a table.
---
## Setup
Verify required environment variables before querying:
```bash
echo "URL: ${SHIPWRIGHT_TASK_STORE_URL:-(missing)}"
echo "Token: ${SHIPWRIGHT_TASK_STORE_TOKEN:+(set)}"
```
Both are provisioned automatically by the agent harness. See the
[task-store skill](../task-store/SKILL.md) for token creation instructions if
either is missing.
---
## Filters
All filters are optional and can be combined. Pass them as query parameters.
| Filter | Type | Description |
|---|---|---|
| `repo` | `org/repo` | Exact match on repository (e.g. `app-vitals/shipwright`) |
| `prNumber` | integer | Specific PR number |
| `state` | string | PR state: `open`, `merged`, `closed` |
| `reviewState` | string | Review state: `pending`, `in_progress`, `posted`, `approved` |
| `staged` | boolean | `true` or `false` — filter by staging flag |
---
## Examples
### List all PRs
```bash
curl -sf \
-H "Authorization: Bearer $SHIPWRIGHT_TASK_STORE_TOKEN" \
"$SHIPWRIGHT_TASK_STORE_URL/prs" | jq .
```
### Filter by repo
```bash
curl -sf \
-H "Authorization: Bearer $SHIPWRIGHT_TASK_STORE_TOKEN" \
"$SHIPWRIGHT_TASK_STORE_URL/prs?repo=app-vitals%2Fshipwright" | jq .
```
### Filter by state
```bash
curl -sf \
-H "Authorization: Bearer $SHIPWRIGHT_TASK_STORE_TOKEN" \
"$SHIPWRIGHT_TASK_STORE_URL/prs?state=open" | jq .
```
##