pocket-difflisted
Install: claude install-skill tahaakocer/pocket-diff
# Pocket diff
**Build and publish without reading the diff.** The script runs git and fills the template; you read
only its summary. That is the point — a 50-file diff costs barely more than a 1-file diff.
## Usage
The script sits next to this file. Derive its path from here rather than assuming a home directory:
`${CLAUDE_PLUGIN_ROOT}/skills/pocket-diff/scripts/build_diff_page.py` as a plugin,
`~/.claude/skills/pocket-diff/scripts/build_diff_page.py` as a personal skill.
1. `python3 <path>/build_diff_page.py --out <scratchpad>/diff-page.html`
2. Read the stdout summary. Do **not** open, read or edit the page.
3. `Artifact(file_path="<scratchpad>/diff-page.html", icon="diff", description="<title> — file-by-file diff")`
4. Reply with the link and one line: how many files, source vs tests, +/−.
Called again in the same session, write to the same path and publish again — the URL stays and open
pages update themselves. To update a page from an earlier session, pass its `url`.
## Options
| Flag | What it does |
|---|---|
| `--repo PATH` | Repository, repeatable. Default: working directory. Pass several when one change spans a service and a library. |
| `--range REV` | `main...HEAD`, `HEAD~3`, `abc..def`. Default: working tree + staged against `HEAD`. |
| `--staged` | Staged changes only. |
| `--paths ...` | Pathspec filter, e.g. `--paths src/main`. |
| `--context N` | Context lines, default 12. |
| `--title`, `--eyebrow` | Page heading. Default title: the ticket key in the