Art
npx machina-cli add skill b1rdmania/claude-brand-skills/art --openclawArt Skill — Image Generation
A CLI tool for generating images from text prompts using multiple AI models. Used by the brand-skill in Phase 2 (Visual Direction) and Phase 3 (Mark Development) for reference image generation.
The Tool
Tools/Generate.ts — A multi-model image generation CLI that supports:
| Model | Flag | API Key | Best for |
|---|---|---|---|
| Gemini (nano-banana-pro) | --model nano-banana-pro | GOOGLE_API_KEY | Best quality, text rendering |
| Replicate (nano-banana) | --model nano-banana | REPLICATE_API_TOKEN | Faster iteration |
| Flux | --model flux | REPLICATE_API_TOKEN | High quality, stylistic variety |
| GPT Image | --model gpt-image-1 | OPENAI_API_KEY | Alternative generation |
Setup
- Install bun runtime:
curl -fsSL https://bun.sh/install | bash - Set at least one API key as an environment variable
- Run with:
bun run Tools/Generate.ts --model [MODEL] --prompt "[PROMPT]" --output ~/Downloads/output.png
Usage
# Basic generation
bun run Tools/Generate.ts \
--model nano-banana-pro \
--prompt "Abstract minimalist logo concept: [description]. Clean vector style, dark background. No text." \
--size 2K \
--aspect-ratio 1:1 \
--output ~/Downloads/brand-ref-1.png
# With background removal (useful for marks)
bun run Tools/Generate.ts \
--model nano-banana-pro \
--prompt "[PROMPT]" \
--size 2K \
--remove-bg \
--output ~/Downloads/mark-reference.png
# With reference image for style consistency
bun run Tools/Generate.ts \
--model nano-banana-pro \
--prompt "[PROMPT]" \
--reference-image existing-mark.png \
--size 2K \
--output ~/Downloads/variation.png
Flags
| Flag | Options | Default | Purpose |
|---|---|---|---|
--model | nano-banana-pro, nano-banana, flux, gpt-image-1 | nano-banana-pro | Image generation model |
--prompt | text | (required) | The generation prompt |
--size | 1K, 2K, 4K (or aspect like 16:9) | 16:9 | Output resolution or aspect ratio |
--aspect-ratio | 1:1, 16:9, 9:16, 3:2, 21:9 | 16:9 | Aspect ratio (Gemini nano-banana-pro) |
--output | path | ~/Downloads/generated-image.png | Output file path |
--remove-bg | (flag) | off | Remove background (requires REMOVEBG_API_KEY) |
--thumbnail | (flag) | off | Generate both transparent + background versions (enables --remove-bg) |
--reference-image | path (repeatable) | none | Style/content reference (nano-banana-pro only) |
--creative-variations | number | 1 | Generate multiple variations (-v1, -v2, etc.) |
In the Brand Process
Phase 2 — Visual Direction (Mode A):
Generate 3-4 reference images exploring different visual interpretations of the brand concept. Use --aspect-ratio 1:1 for logo references (default is 16:9). High resolution, abstract/minimalist prompts.
Phase 3 — Mark Development (Path A):
Generate high-contrast reference images for bitmap tracing with vtracer. Use --remove-bg for clean marks. Trace the result to SVG.
Tips
- Always output to
~/Downloads/first for preview - Square (1:1) aspect ratio works best for logo references
- Include "no text" in prompts for logo/mark references
- Use
--remove-bgwhen generating marks for tracing - Keep prompts abstract: "minimalist logo concept" not "a logo for my company"
nano-banana-prohandles text rendering best if you need labels
Source
git clone https://github.com/b1rdmania/claude-brand-skills/blob/master/art/SKILL.mdView on GitHub Overview
Art is a CLI tool that generates images from text prompts using multiple AI models (Gemini nano-banana-pro, Replicate nano-banana, Flux, GPT Image). It’s used to produce reference images, illustrations, or visual content for brand direction and mark development. Outputs are saved locally for review and iteration.
How This Skill Works
The tool uses Tools/Generate.ts, a multi-model image generation CLI that accepts --model, --prompt, --size, --aspect-ratio, --output, and optional flags like --remove-bg or --reference-image. You select a model, craft a prompt, and run the command to generate and save an image to your specified path. The CLI supports different models for quality, speed, and stylistic variety.
When to Use It
- During Phase 2 Visual Direction to generate 3-4 reference images exploring different visual interpretations (use --aspect-ratio 1:1 for logos).
- When you need high-quality text rendering for logos or illustrations, prefer Gemini nano-banana-pro.
- For rapid iteration cycles, leverage Replicate nano-banana to test prompts quickly.
- When creating high-contrast reference images for bitmap tracing in Phase 3, use --remove-bg for clean marks.
- When you want style-consistent variations, supply a reference image with --reference-image to guide similarity.
Quick Start
- Step 1: Install bun runtime and ensure at least one API key is set in your environment.
- Step 2: Run a generate command with your chosen model and prompt, e.g., bun run Tools/Generate.ts --model nano-banana-pro --prompt Abstract minimalist logo concept: clean vector, dark background. No text. --size 2K --aspect-ratio 1:1 --output ~/Downloads/brand-ref-1.png
- Step 3: Open the image in ~/Downloads, then refine prompts or switch models for better results.
Best Practices
- Output previews to ~/Downloads/ first for quick review.
- Use 1:1 aspect ratio for logo references; reserve wider aspect ratios for illustrations.
- Include no text in prompts for logo/mark references to avoid unwanted typography.
- Use --remove-bg when generating marks intended for tracing or SVG conversion.
- If visuals drift, use --reference-image to anchor style and content.
Example Use Cases
- Logo reference: Abstract minimalist logo concept, clean vector style, dark background, no text. Model nano-banana-pro, size 2K, aspect 1:1, output ~/Downloads/brand-logo-ref.png
- Mark reference: High-contrast geometric mark with clean edges, remove-bg for SVG tracing. Model nano-banana-pro, size 2K, remove-bg, output ~/Downloads/mark-ref.png
- Illustration for Phase 2: Friendly product illustration, Flux model, size 2K, aspect 16:9, output ~/Downloads/product-illus.png
- Style-consistency variation: Use existing-mark.png as reference image for style. Model nano-banana-pro, size 2K, output ~/Downloads/variation.png
- Fast iteration: Quick concepts with Replicate nano-banana, size 2K, aspect 1:1, output ~/Downloads/quick-idea.png
