pr-describerlisted
Install: claude install-skill nanoodlecom/noodle-skills
# PR describer
Runs the bundled nanoodle workflow `workflows/pr-describe.noodle-graph.json` against the
NanoGPT API — a three-stage text pipeline over one input (`Diff`): a drafter writes a
conventional PR body (summary, `## Changes`, `## Test plan`), an auditor compares the draft
against the raw diff and lists every breaking change, behavioral shift, or touched file the
draft omits, and a reviser emits the final markdown (`Final PR body`) with every audit
finding folded in (adding `## Breaking changes` when needed). Requires Node.js >= 20 and
the `nanoodle` npm package (`npx nanoodle` fetches it).
## API key
The run needs a NanoGPT API key. Use whichever is available:
- `NANOGPT_API_KEY` already set in the environment — prefer this; no extra flags.
- A `.env` file containing `NANOGPT_API_KEY=...` — pass `--env-file <path>` only when the
key is not already in the environment. (With this CLI, `--env-file` overrides ambient
`NANOGPT_API_KEY`.)
Never print the key.
## Run
From this skill's directory (or prefix paths if running from elsewhere). Write the branch
diff to a `.txt` file first (`@path` reads `.txt`/`.md` files as text):
```sh
npx nanoodle run workflows/pr-describe.noodle-graph.json \
--input "Diff=@/tmp/pr-diff.txt"
```
Producing the diff file is the usual one-liner, e.g.
`git diff origin/main...HEAD > /tmp/pr-diff.txt`.
The output is text, so no `--out` directory is needed. Pipe the body straight into GitHub:
```sh
npx nanoodle run workflows/pr-descr