Illustration Generation (Quiver Arrow)
Prompt-to-SVG via Quiver's Arrow 1.1 model. Black-box generation, paid per call.
When to use this vs scientific-drawing
| Task |
Use |
| Logo, icon, decorative illustration, stylized graphic |
illustration-gen |
| Architecture/ERD/flowchart, math diagram, plot, technical figure |
scientific-drawing |
| Anything where you'll edit control points, replay deterministically, or version-control the source |
scientific-drawing |
Arrow generates non-deterministically and costs credits per call. The output is editable SVG, but you can't re-derive it from source — re-prompting gives a different result.
Setup (one-time)
# Get a key at app.quiver.ai \u2192 API keys, then:
export QUIVERAI_API_KEY=qvr_...
Add the export to ~/.zshrc (or ~/.config/zsh/.env) for persistence.
Usage
uv run python3 ~/Projects/skills/illustration-gen/scripts/generate.py "a minimalist fox logo" -o fox.svg
Flags:
| Flag |
Default |
Notes |
-o, --output |
illustration-<ts>.svg |
With --n>1, becomes <stem>_<i>.svg |
-m, --model |
arrow-1.1 |
Use arrow-1.1-max for detailed assets (higher cost) |
-i, --instructions |
none |
Refinements: palette, line weight, style constraints |
-n, --n |
1 |
Number of variants |
Examples:
# Single output
uv run python3 ~/Projects/skills/illustration-gen/scripts/generate.py \
"isometric server rack with cables" -o rack.svg
# Higher-quality model with style instructions
uv run python3 ~/Projects/skills/illustration-gen/scripts/generate.py \
"abstract geometric crest" \
-m arrow-1.1-max \
-i "two-color flat fill, no gradients, thick strokes" \
-o crest.svg
# Multiple variants for selection
uv run python3 ~/Projects/skills/illustration-gen/scripts/generate.py \
"lab notebook icon" -n 4 -o notebook.svg
# \u2192 notebook_0.svg, notebook_1.svg, notebook_2.svg, notebook_3.svg
API contract
- Endpoint:
POST https://api.quiver.ai/v1/svgs/generations
- Auth:
Authorization: Bearer $QUIVERAI_API_KEY
- Models:
arrow-1.1, arrow-1.1-max
- Response:
{id, created, data: [{svg, mime_type}], credits}
Pricing: prepaid credits (see quiver.ai/pricing). Script prints credits charged on each call.
Troubleshooting
| Problem |
Fix |
QUIVERAI_API_KEY not set |
Export the key (see Setup) |
HTTP 401 |
Key invalid or revoked — regenerate at app.quiver.ai |
HTTP 402 |
Out of credits — top up at quiver.ai/pricing |
HTTP 429 |
Rate-limited — back off and retry |
| Non-SVG response |
Check the printed payload; report upstream if persistent |
$ARGUMENTS
1---2name: illustration-gen3description: "Use when: paid Quiver Arrow SVG logo/icon from prompt. NOT precise technical diagrams (/scientific-drawing)."4user-invocable: true5argument-hint: '[description of illustration]'6allowed-tools: [Bash, Read, Write]7effort: low8metadata:9 source: https://skillmd.com/skills/markusstrasser/illustration-gen10---1112# Illustration Generation (Quiver Arrow)1314Prompt-to-SVG via Quiver's Arrow 1.1 model. Black-box generation, paid per call.1516## When to use this vs scientific-drawing1718| Task | Use |19|------|-----|20| Logo, icon, decorative illustration, stylized graphic | **illustration-gen** |21| Architecture/ERD/flowchart, math diagram, plot, technical figure | **scientific-drawing** |22| Anything where you'll edit control points, replay deterministically, or version-control the source | **scientific-drawing** |2324Arrow generates non-deterministically and costs credits per call. The output is editable SVG, but you can't re-derive it from source — re-prompting gives a different result.2526## Setup (one-time)2728```bash29# Get a key at app.quiver.ai \u2192 API keys, then:30export QUIVERAI_API_KEY=qvr_...31```3233Add the export to `~/.zshrc` (or `~/.config/zsh/.env`) for persistence.3435## Usage3637```bash38uv run python3 ~/Projects/skills/illustration-gen/scripts/generate.py "a minimalist fox logo" -o fox.svg39```4041Flags:4243| Flag | Default | Notes |44|------|---------|-------|45| `-o, --output` | `illustration-<ts>.svg` | With `--n>1`, becomes `<stem>_<i>.svg` |46| `-m, --model` | `arrow-1.1` | Use `arrow-1.1-max` for detailed assets (higher cost) |47| `-i, --instructions` | none | Refinements: palette, line weight, style constraints |48| `-n, --n` | 1 | Number of variants |4950Examples:5152```bash53# Single output54uv run python3 ~/Projects/skills/illustration-gen/scripts/generate.py \55 "isometric server rack with cables" -o rack.svg5657# Higher-quality model with style instructions58uv run python3 ~/Projects/skills/illustration-gen/scripts/generate.py \59 "abstract geometric crest" \60 -m arrow-1.1-max \61 -i "two-color flat fill, no gradients, thick strokes" \62 -o crest.svg6364# Multiple variants for selection65uv run python3 ~/Projects/skills/illustration-gen/scripts/generate.py \66 "lab notebook icon" -n 4 -o notebook.svg67# \u2192 notebook_0.svg, notebook_1.svg, notebook_2.svg, notebook_3.svg68```6970## API contract7172- Endpoint: `POST https://api.quiver.ai/v1/svgs/generations`73- Auth: `Authorization: Bearer $QUIVERAI_API_KEY`74- Models: `arrow-1.1`, `arrow-1.1-max`75- Response: `{id, created, data: [{svg, mime_type}], credits}`7677Pricing: prepaid credits (see quiver.ai/pricing). Script prints credits charged on each call.7879## Troubleshooting8081| Problem | Fix |82|---------|-----|83| `QUIVERAI_API_KEY not set` | Export the key (see Setup) |84| `HTTP 401` | Key invalid or revoked — regenerate at app.quiver.ai |85| `HTTP 402` | Out of credits — top up at quiver.ai/pricing |86| `HTTP 429` | Rate-limited — back off and retry |87| Non-SVG response | Check the printed payload; report upstream if persistent |8889$ARGUMENTS