agentleFS
TermiX-officialTermiX-official/cryptoclaw/skills/openai-image-gen/SKILL.md

openai-image-gen

Skill100 starsChanged 9 months agoMITView on GitHub

Batch-generate images via OpenAI Images API. Random prompt sampler + `index.html` gallery.

  • Reads credentials

We split this skill into the rules it gives an agent

2 rules. 0 are common, 1 is distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 12 edited versions we read keep these.

  • 1

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    When invoking this skill via OpenClaw’s exec tool, set a higher timeout to avoid premature termination/retries (e.g., exec timeout=300).

    line 33
  2. Very specific:

    dall-e-3: only supports generating 1 image at a time (n=1).

    line 81

“Common” is measured: kept by at least 6 in 10 of the 12 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

OpenAI Image Gen

Generate a handful of “random but structured” prompts and render them via the OpenAI Images API.

Run

Note: Image generation can take longer than common exec timeouts (for example 30 seconds). When invoking this skill via OpenClaw’s exec tool, set a higher timeout to avoid premature termination/retries (e.g., exec timeout=300).

python3 {baseDir}/scripts/gen.py
open ~/Projects/tmp/openai-image-gen-*/index.html  # if ~/Projects/tmp exists; else ./tmp/...

Useful flags:

# GPT image models with various options
python3 {baseDir}/scripts/gen.py --count 16 --model gpt-image-1
python3 {baseDir}/scripts/gen.py --prompt "ultra-detailed studio photo of a lobster astronaut" --count 4
python3 {baseDir}/scripts/gen.py --size 1536x1024 --quality high --out-dir ./out/images
python3 {baseDir}/scripts/gen.py --model gpt-image-1.5 --background transparent --output-format webp

# DALL-E 3 (note: count is automatically limited to 1)
python3 {baseDir}/scripts/gen.py --model dall-e-3 --quality hd --size 1792x1024 --style vivid
python3 {baseDir}/scripts/gen.py --model dall-e-3 --style natural --prompt "serene mountain landscape"

# DALL-E 2
python3 {baseDir}/scripts/gen.py --model dall-e-2 --size 512x512 --count 4

Model-Specific Parameters

Different models support different parameter values. The script automatically selects appropriate defaults based on the model.

Size

  • GPT image models (gpt-image-1, gpt-image-1-mini, gpt-image-1.5): 1024x1024, 1536x1024 (landscape), 1024x1536 (portrait), or auto
    • Default: 1024x1024
  • dall-e-3: 1024x1024, 1792x1024, or 1024x1792
    • Default: 1024x1024
  • dall-e-2: 256x256, 512x512, or 1024x1024
    • Default: 1024x1024

Quality

  • GPT image models: auto, high, medium, or low
    • Default: high
  • dall-e-3: hd or standard
    • Default: standard
  • dall-e-2: standard only
    • Default: standard

Other Notable Differences

  • dall-e-3 only supports generating 1 image at a time (n=1). The script automatically limits count to 1 when using this model.
  • GPT image models support additional parameters:
    • --background: transparent, opaque, or auto (default)
    • --output-format: png (default), jpeg, or webp
    • Note: stream and moderation are available via API but not yet implemented in this script
  • dall-e-3 has a --style parameter: vivid (hyper-real, dramatic) or natural (more natural looking)

Output

  • *.png, *.jpeg, or *.webp images (output format depends on model + --output-format)
  • prompts.json (prompt → file mapping)
  • index.html (thumbnail gallery)

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.