Chatgpt imagegen

Skill iurysza/agent-skills/skills/chatgpt-imagegen

Shareable skills for clankers

Install

npx -y skills add iurysza/agent-skills --skill chatgpt-imagegen

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

19 days oldThe repository was created 19 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Generates or edits raster images through OpenAI's Image API. Use for text-to-image work, reference-based edits, masks, transparent assets, and product or editorial visuals.

SKILL.md

2.8 KB, as published. Nobody here has run it

ChatGPT Image Generation

Use the bundled chatgpt-img CLI for generation and edits. Resolve its path relative to this SKILL.md.

Setup

python3 -m pip install -r <skill-directory>/requirements.txt
export OPENAI_API_KEY='...'

OPENCODE_OPENAI_API_KEY is accepted as a fallback. CHATGPT_IMAGE_DEFAULT overrides the default model.

Image requests cost money. Confirm scope before generating many images or using high quality repeatedly.

Generate

<skill-directory>/scripts/chatgpt-img \
  'A linocut illustration of a lighthouse in heavy rain' \
  ./lighthouse.png \
  --size 1536x1024 \
  --quality high

Edit

Single reference:

<skill-directory>/scripts/chatgpt-img edit \
  ./portrait.png \
  'Use warm editorial lighting; preserve identity, pose, and clothing' \
  ./portrait-edited.png \
  --quality high

Multiple references:

<skill-directory>/scripts/chatgpt-img \
  --input ./portrait.png \
  --input ./moodboard.png \
  'Apply the moodboard lighting and palette while preserving the portrait identity' \
  ./portrait-styled.png

Optional masked edit:

<skill-directory>/scripts/chatgpt-img edit \
  ./input.png \
  'Replace the masked background with a cloudy coastline' \
  ./output.png \
  --mask ./mask.png

Important options

--model: defaults to gpt-image-2
--size: supported dimensions or auto
--quality: GPT Image uses auto, low, medium, or high
--background: auto, transparent, or opaque
--format: png, jpeg, or webp
--compression: 0 through 100 for JPEG/WebP
--num: number of outputs
--input: repeatable reference image for edit mode
--mask: optional edit mask
--input-fidelity: supported by selected older GPT Image models, not gpt-image-2

Use --help and edit --help for the complete interface.

Prompting edits

State both the change and the invariants. For example, name the identity, geometry, text, logos, pose, camera angle, or materials that must remain unchanged. Describe lighting, palette, composition, and finish positively instead of relying on long negative lists.

Verification

Check the process exit status.
Confirm every expected output file exists and is non-empty.
Report exact paths and any revised prompt returned by the API.
Inspect the image with an available viewer when visual verification is part of the task.

Never expose API keys. Error output may include safe request metadata, but it must not include prompt contents or credentials.