2.1 KiB
| name | description |
|---|---|
| gen-image | Generate images via Banatie API — text-to-image with optional reference images, aspect ratios, and enhancement templates |
Image Generation Skill
Generate images using the Banatie API. Parses user arguments, validates inputs, and runs the generation script.
Arguments
Parse these from the user's message. Use AskUserQuestion for any missing required arguments.
| Argument | Required | Default | Description |
|---|---|---|---|
| Prompt | Yes | — | Image description |
| Output path | Yes | — | Where to save the file (e.g. assets/icons/star.png) |
| Aspect ratio | No | 1:1 |
1:1, 16:9, 9:16, 3:2, 4:3, 3:4, 21:9 |
| Reference images | No | — | Local file paths or @alias names (max 3) |
| Enhancement template | No | general |
general, photorealistic, illustration, minimalist, sticker, product, comic |
Workflow
-
Parse arguments from the user's message. Extract prompt, output path, aspect ratio, references, and template inline where provided.
-
Fill missing required arguments using
AskUserQuestion. Suggest an output path based on context (e.g.assets/backgrounds/for backgrounds,assets/icons/for icons). -
Validate that any referenced local files exist before proceeding.
-
Read API docs from
docs/subfolder when the user needs advanced features (references, flows, aliases). The docs are:docs/image-generation.md— basic generation, aspect ratios, prompt enhancement, templatesdocs/image-generation-advanced.md— reference images, aliases, flows, regenerationdocs/images-upload.md— image upload, alias management
-
Run generation:
node .claude/skills/gen-image/banatie-gen.mjs --prompt "<prompt>" --output <path> [--aspect-ratio <ratio>] [--ref <file_or_alias>]... -
Report results: output file path, image dimensions, and the full command for reproducibility.
Environment
The script reads BANATIE_KEY from .env in the project root. Rate limit: 100 requests/hour.