About gpt-image-prompts
A skill for producing structured prompts and API-setting recommendations for OpenAI GPT Image models, with gpt-image-2 as the default. It is intended for people creating image-generation briefs and includes guidance for iterative edits.
Key features
- 01Ready-to-use image prompts
- 02Recommended API settings
- 03Optional refinement prompts
- 04Model-specific constraints
- 05Prompt patterns for varied deliverables
Use cases
- 01Drafting prompts for product ads and editorial images
- 02Specifying text-heavy graphics or infographics
- 03Refining an image while preserving its layout
- 04Preparing prompts for image edits or compositing
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ scottwater/ skills --skill gpt-image-promptsAfter installing, type/gpt-image-promptsin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
PATTERNS.mdREADME.mdagents/openai.yamlDetails
From the project READMEGPT Image Prompt Generator
Generate prompts for OpenAI GPT Image models, with gpt-image-2 as the default target. Treat the model like a production designer who follows a clear creative brief: define the goal, visual deliverable, subject, composition, constraints, and exact text.
Primary reference: OpenAI's GPT Image Generation Models Prompting Guide: https://developers.openai.com/cookbook/examples/multimodal/image-gen-models-prompting-guide
Output
Unless the user asks for another format, return:
- Ready-to-use prompt in a fenced code block.
- Recommended API settings:
model,size,quality,background,output_format, and notes fornor edit inputs if relevant. - Optional refinement prompts: one or two short follow-up edits that improve a likely first pass.
If critical details are missing, ask only the minimum clarifying questions needed. Otherwise, make tasteful assumptions and state them briefly.
Model defaults and constraints
- Default model:
gpt-image-2. - Quality: use
lowfor fast drafts, thumbnails, and broad exploration; usemediumfor most production prompts; usehighfor dense text, small labels, infographics, slide/chart outputs, close-up portraits, identity-sensitive edits, and final assets. - Size: use a concrete size when the output format is known; otherwise use
auto.- Common sizes:
1024x1024,1536x1024,1024x1536,2048x2048,2048x1152,3840x2160,2160x3840. gpt-image-2size constraints: both edges multiples of 16px; max edge ≤ 3840px; long:short ratio ≤ 3:1; total pixels from 655,360 to 8,294,400.- Outputs above
2560x1440are more variable/experimental; prefer 2K or below for reliability unless the user needs 4K.
- Common sizes:
- Background:
gpt-image-2does not support transparent backgrounds. Usebackground: "opaque"for product extraction and plain-background assets; use downstream background removal if transparency is required. - Input fidelity: omit
input_fidelityforgpt-image-2; it processes inputs at high fidelity by default. - Output format: default
png; choosejpegfor lower latency/photo workflows; choosewebpfor compressed web assets. - Variations: use
nwhen the user wants multiple directions, logos, thumbnails, or ad concepts.
Golden rules
- Write a creative brief, not tag soup. Natural language and labeled sections are better than keyword piles.
- Lead with purpose. Include what the asset is for: product ad, editorial hero image, UI mockup, classroom handout, pitch-deck slide, marketplace listing, etc.
- Use a stable prompt order. Background/scene → subject → details → composition → style/medium → constraints → exact text.
- Name the visual medium explicitly. Use phrases like
photorealistic,vector-like logo,flat scientific diagram,mobile app UI mockup,pitch-deck slide, orcomic strip. - Specify composition. Framing, viewpoint, subject placement, negative space, camera angle, lighting, mood, and color palette all matter.
- Preserve invariants in edits. Use “change only X; keep everything else the same,” then list the preserved identity/layout/geometry/typography/lighting elements.
- Quote exact text. Put in-image copy in quotes and specify typography, placement, contrast, and “no extra text.” For hard spellings, spell words letter by letter.
- Iterate surgically. For an 80%+ good result, write narrow follow-up prompts instead of re-rolling: “make the lighting warmer,” “remove the extra label,” “restore the original background.”
Prompt structure template
Use labeled sections for complex or production prompts:
Create [DELIVERABLE] for [PURPOSE/AUDIENCE].
Scene / background:
[Environment, era, mood, context, world details]
Subject:
[Main subject with concrete attributes, materials, identity cues, pose/action]
Composition:
[Framing, viewpoint, camera angle, placement, negative space, layout hierarchy]
Style / medium:
[Photorealistic / editorial / vector / 3D render / UI / diagram / comic, color palette, lighting]
Text, if any:
Render exactly: "..."
[Typography, size, placement, contrast]
Constraints:
[No extra text, no watermark, no unrelated logos, preserve X, avoid Y]
For simple requests, a polished paragraph is enough. For production work, labeled sections are easier to debug and reuse.
Capability patterns
For guidance specific to the deliverable — photorealism, people and pose, text and infographics, ads, logos, UI mockups, slides and charts, product shots, edits and localization, multi-image compositing, comics — load PATTERNS.md and apply the sections that match the request.