How do I install the Image Gen skill?

Run npx skillmds@latest add maxgent-ai/image-gen in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Image Gen safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Image Gen?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Image Gen free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Image Gen?

maxgent-ai (@maxgent-ai) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Image Gen by maxgent-ai — Agent Skill

Name: Image Gen
Author: maxgent-ai

File contents

Image Generator

Generate or edit images via Maxgent FAL API proxy.

Prerequisites

MAX_API_KEY environment variable (auto-injected by Max)
Bun 1.0+ (built into Max)

Default Routing

Text-to-image (default): fal-ai/nano-banana-pro
Image editing (default): fal-ai/nano-banana-pro/edit

Usage

bun skills/image-gen/image-gen.js \
  --model MODEL --prompt "PROMPT" --aspect-ratio RATIO \
  --num-images N --output-dir DIR \
  [--input-image PATH] [--output-format FORMAT] \
  [--seed N] [--guidance-scale X] [--steps N]

Parameters:

--model: auto (recommended), gpt-image-1.5, nano-banana-pro, flux-dev
--prompt: image description or editing instruction
--aspect-ratio: 1:1, 4:3, 3:4, 16:9, 9:16
--num-images: number of images to generate (default 1)
--output-dir: output directory — default to $MAX_PROJECT_PATH (the user's project root)
--input-image: optional, for image editing mode
--output-format: png, jpg, webp (default png)
--seed: random seed for reproducibility
--guidance-scale: guidance scale for supported models
--steps: number of inference steps for supported models

Examples

# Default routing, text-to-image
bun skills/image-gen/image-gen.js --model auto --prompt "a cat under the starry sky" --aspect-ratio "1:1" --output-dir "$MAX_PROJECT_PATH"

# Specify model
bun skills/image-gen/image-gen.js --model gpt-image-1.5 --prompt "modern building facade, cinematic" --aspect-ratio "16:9" --num-images 2 --output-dir "$MAX_PROJECT_PATH"

# Image editing
bun skills/image-gen/image-gen.js --model auto --prompt "change background to a beach at sunset" --aspect-ratio "1:1" --output-dir "$MAX_PROJECT_PATH" --input-image "/path/to/input.jpg"

Instructions

Check that MAX_API_KEY exists.
Use AskUserQuestion to collect: edit or generate, prompt, aspect ratio, count. Default output path to $MAX_PROJECT_PATH.
Run the script and wait for result.
On success, report the output path.
On failure:
- HTTP 402 (insufficient credits): Stop immediately. Do NOT retry. Tell the user their API credits are exhausted.
- Other errors: retry once with a different model or simplified prompt. If it fails again, stop and report the error.

---name: image-gendescription: AI image generation and editing. Use when users ask to generate, create, or draw images with AI, or edit and modify existing images.---# Image GeneratorGenerate or edit images via Maxgent FAL API proxy.## Prerequisites1. `MAX_API_KEY` environment variable (auto-injected by Max)2. Bun 1.0+ (built into Max)## Default Routing1. Text-to-image (default): `fal-ai/nano-banana-pro`2. Image editing (default): `fal-ai/nano-banana-pro/edit`## Usage```bashbun skills/image-gen/image-gen.js \ --model MODEL --prompt "PROMPT" --aspect-ratio RATIO \ --num-images N --output-dir DIR \ [--input-image PATH] [--output-format FORMAT] \ [--seed N] [--guidance-scale X] [--steps N]```Parameters:- `--model`: `auto` (recommended), `gpt-image-1.5`, `nano-banana-pro`, `flux-dev`- `--prompt`: image description or editing instruction- `--aspect-ratio`: `1:1`, `4:3`, `3:4`, `16:9`, `9:16`- `--num-images`: number of images to generate (default `1`)- `--output-dir`: output directory — **default to `$MAX_PROJECT_PATH`** (the user's project root)- `--input-image`: optional, for image editing mode- `--output-format`: `png`, `jpg`, `webp` (default `png`)- `--seed`: random seed for reproducibility- `--guidance-scale`: guidance scale for supported models- `--steps`: number of inference steps for supported models## Examples```bash# Default routing, text-to-imagebun skills/image-gen/image-gen.js --model auto --prompt "a cat under the starry sky" --aspect-ratio "1:1" --output-dir "$MAX_PROJECT_PATH"# Specify modelbun skills/image-gen/image-gen.js --model gpt-image-1.5 --prompt "modern building facade, cinematic" --aspect-ratio "16:9" --num-images 2 --output-dir "$MAX_PROJECT_PATH"# Image editingbun skills/image-gen/image-gen.js --model auto --prompt "change background to a beach at sunset" --aspect-ratio "1:1" --output-dir "$MAX_PROJECT_PATH" --input-image "/path/to/input.jpg"```## Instructions1. Check that `MAX_API_KEY` exists.2. Use AskUserQuestion to collect: edit or generate, prompt, aspect ratio, count. Default output path to `$MAX_PROJECT_PATH`.3. Run the script and wait for result.4. On success, report the output path.5. On failure: - **HTTP 402 (insufficient credits)**: **Stop immediately. Do NOT retry.** Tell the user their API credits are exhausted. - Other errors: retry once with a different model or simplified prompt. If it fails again, stop and report the error.

Frequently asked questions

Image Gen