capturing-screenshotslisted
Install: claude install-skill bostonaholic/skills
# Capturing screenshots
Output: PNGs plus `manifest.md` in `--out` (default
`$(mktemp -d)/screenshots`). With `--url`, shoot the app running there.
## Rules
- **Shoot what was asked.** When a name matches no screen, several, or
nothing was named, ask one question instead of guessing.
- **Deterministic frames.** Mask volatile content (timestamps, avatars, IDs).
Wait on a condition, never `sleep`; shoot a loading state only when a
`waitFor` can hold it.
- **Look at every frame** against its caption: right screen and state,
nothing obscuring or faking it (spinner, skeleton, error overlay, login
wall, `undefined` or placeholder text). An unviewed frame is reported as
"not visually verified". Never caption around a defect.
- **Nothing sensitive in frame.** Prefer seeded data; mask or skip the rest.
Skip auth-gated routes.
- **Capture only.** Write only to `--out` and a temporary directory. No
commits, pushes, or PR edits. Even after a failure, stop each server this
run started by its recorded PID (never by name) and only devices it booted.
- **Bounds:** at most 10 shots unless the caller names more; one retake per
failed shot with a changed spec, then skip it with the reason.
- **Degrade, never block.** No browser is `status: skipped-no-tool`; an app
that will not start is `status: skipped-server-start`.
## Browser
If `scripts/shoot.mjs` exits 3 (no Playwright), tell the user, then install
into a cache, never into the project:
```bash
export PAPARAZZI_T