gpt-image

Generate PNG images, posters, and logo boards via the Codex image_generation API.

Updated Sep 14, 2026
One-click install
npx skills add https://github.com/Suge8/skills --skill gpt-image-suge8
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gpt-image
Source: https://github.com/Suge8/skills/tree/main/creative/gpt-image
Command: npx skills add https://github.com/Suge8/skills --skill gpt-image-suge8

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Creating AI-generated images, posters, illustrations, or logo proposal boards normally requires manual interaction with a chat interface; this Skill automates PNG generation directly from the command line using the Codex hosted image_generation tool. ## Core Features & Use Cases - Scripted Image Generation: Runs a Python script that calls the Codex /responses endpoint with the image_generation tool and saves the result as a PNG file. - Reference Image Support: Accepts repeatable --ref image inputs plus size and quality parameters to guide generation. - Logo Collection Boards: Provides a detailed reference prompt template for producing modernist black-and-white series logo proposal boards in 2:3 vertical format. - Use Case: A designer needs a vintage-style logo collection board for a coffee brand; the Skill loads the logo guide, fills in brand fields, and generates a print-ready PNG in one command. ## Quick Start Ask the agent to generate an image with a descriptive prompt and an absolute output path, for example to create a poster saved as /tmp/poster.png.

Frequently Asked Questions about gpt-image

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate an AI image from the command line?▼

Run python3 scripts/gpt_image.py with your prompt and an --out absolute PNG path. The script calls the Codex /responses endpoint with the image_generation tool and writes the decoded PNG to disk, printing a JSON result with path and size.

How to generate a series logo proposal board with AI?▼

Read the reference/logo.md guide first, collect brand theme, English name, industry, and keywords, then fill them into the provided prompt template. Generate the image in vertical 2:3 format using the bundled script.

What authentication does the Codex image generation script need?▼

The script reads tokens.access_token and tokens.account_id from ~/.codex/auth.json. Both values must exist or it raises a runtime error; credentials are sent only to the chatgpt.com Codex backend endpoint.

Can I pass reference images to guide image generation?▼

Yes, use the repeatable --ref flag with PNG or JPEG paths. Each reference image is base64-encoded and added as an input_image content item alongside the text prompt.

Why does image generation fail with no result error?▼

The error occurs when the SSE stream contains no image_generation_call with a result field, typically due to API rejection, expired tokens, or content policy blocks. Check the JSON error output for the HTTP status and response body.