# Poster Generator

> Generate a poster image from a short idea — an LLM expands the idea into a detailed image prompt, then an image model renders it. Use when the user asks for a poster, illustration, or promo image from a one-line concept.

- Skill: `nanoodlecom/poster-generator` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add nanoodlecom/poster-generator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/nanoodlecom/poster-generator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Design & Media
- Author: nanoodlecom (https://skillmd.com/u/nanoodlecom)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/nanoodlecom/poster-generator

---


# Poster generator

Runs the bundled nanoodle workflow `workflows/poster.noodle-graph.json` against the NanoGPT
API: a text input (`Idea`) feeds an LLM that writes a vivid image prompt, which feeds an
image model that renders the poster (`Poster`). 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):

```sh
npx nanoodle run workflows/poster.noodle-graph.json \
  --input "Idea=<the user's poster idea, e.g. a cozy ramen shop on a rainy night>" \
  --out ./poster-out
```

Add `--env-file .env` only when the key is not already exported. The CLI always prints a
machine-readable JSON summary (paths, cost, balance) to stdout; add `--json` to silence the
stderr progress lines.

Optional style override (workflow also exposes this input):

```sh
--input "System prompt=<custom image-prompt writer instructions>"
```

Inspect the interface anytime with:

```sh
npx nanoodle inspect workflows/poster.noodle-graph.json
```

## Outputs

- Media is saved under `--out` (default `./noodle-out`) as `Poster.<ext>` where `<ext>`
  follows the image MIME (often `jpg` or `png`). **Use the `outputs.Poster` path from the
  JSON summary on stdout** — do not hard-code `.png`.
- The CLI also prints progress, saved-file lines, and total cost (with remaining balance
  when the API reports it) to stderr.

## Cost

Each run costs about **$0.04** in NanoGPT credit (the image-generation step dominates; the
LLM prompt-writing step is a fraction of a cent).