occamlisted
Install: claude install-skill sgtlaugh/skills
# /occam - review your own change before it ships
The review you'd otherwise type by hand: *"review the changes thoroughly - any issues, drifts, simplifications?"* - done by a reviewer that didn't write the code. Occam's razor is the stance: the best change is the smallest one that fully reaches the goal, with nothing broken and nothing left behind.
## Usage
```
/occam # local work: tracked changes vs HEAD + untracked files (default)
/occam <goal> # same, with the goal stated (skips the goal question)
/occam --staged # only what's staged
/occam --last # the last commit
/occam --branch # everything on this branch vs its base
```
## Step 1 - Scope and goal (main context)
- **Scope commands** for the chosen mode - resolve them to literal commands now, since the reviewer runs them in its own shell:
| Mode | Commands |
|---|---|
| default | `git diff HEAD` + `git ls-files --others --exclude-standard` (read each untracked file in full - they are not in the diff) |
| `--staged` | `git diff --cached` |
| `--last` | `git show HEAD` |
| `--branch` | `git diff <merge-base sha>..HEAD`, with the sha resolved here from `git merge-base HEAD <remote>/<base>`. `<remote>` = the remote this branch will be merged into (the org/upstream repo - `git remote -v` shows which URL that is); with several candidates, ask. Never pick a remote because it is listed first - in multi-fork repos that is often a colleague's fo