docent-prlisted
Install: claude install-skill benelser/docent
# docent-pr — the PR-review film
You are running the entire docent cascade in **PR-review mode** against a
pull request the user named: survey → treatment → spec → tts → clips →
render → open. The output is one MP4 that explains the change the way a
principal engineer would: why it exists, whether the design is sound, the
core before → after, what ripples, what could break, and a verdict.
## Arguments
`/docent-pr <repo> <pr-number> [--id X] [--scale S] [--no-open]`
- `<repo>` — a repo path, a GitHub URL (`https://github.com/owner/name`),
or the bare `owner/name` form.
- `<pr-number>` — the pull-request number to review. Can be `123` or
`#123`. If the user pasted a full PR URL as `<repo>`, extract both.
- `--id X` — override the auto-derived film id (default: `<repo-name>-pr`).
- `--scale S` — render scale. Default `1`. Pass `0.5` for fast turnarounds.
- `--no-open` — render without opening the result in the system player.
## What to do
1. **Pre-flight.** Confirm `bun`, `ffmpeg`, and the agent CLI (`claude` or
`codex`) are on PATH. If anything obvious is missing, suggest
`/docent-doctor` and stop.
2. **Survey** — PR mode:
```bash
docent survey <repo> --mode pr --pr <n> [--id X]
```
The survey lands at `analysis/<id>.md`. Surface the path and the
load-bearing finding (section 1 of the survey — the triage) before
moving on. A PR survey's job is **triage**: of the diff, what is the
load-bearing 5% — that you review with depth — and what is