alt-text-writerlisted
Install: claude install-skill nanoodlecom/noodle-skills
# Alt-text writer
Runs the bundled nanoodle workflow `workflows/alt-text.noodle-graph.json` against the
NanoGPT API: an image input (`Image`) feeds a vision model whose question is assembled from
two text nodes — the alt-text rules (`Alt rules`) and an optional house style guide
(`Style guide`) — and the output (`Alt text`) is JSON with `alt_125char` and
`numbered_caption`. Requires Node.js >= 20 and the `nanoodle` npm package (`npx nanoodle`
fetches it).
Typical agent use: mid-PR, glob the repo's images, call this once per file, and write the
returned `alt_125char` into the markup instead of guessing at pixels you cannot see.
## 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). Replace the image
path with the real file (`@path` attaches a local file; an `https://` URL also works):
```sh
npx nanoodle run workflows/alt-text.noodle-graph.json \
--input "Image=@/path/to/image.jpg"
```
The output is text, so no `--out` directory is needed. For a machine-readable payload
(outputs, cost, balance), the run summary JSON is always printed on stdout.
Optional overrides (both hav