wuyoscar/GPT-Image2-Skill / skills/gpt-image
gpt-image
FlaggedGenerate or edit images through the packaged CLI and Reference Gallery, defaulting to GPT Image 2.6 Flare. Use for posters, typography, reference edits, inpainting, native GIFs, sprite animation, image-led websites, and explicit Image 2/2.5/2.6 requests.
references/openai-image-2.5-editing.md
View on GitHub# GPT Image 2.5: references and preservation
Read for reference edits, translation, inpainting and transparent cutouts.
Source check: **2026-09-09**;
[provenance and validation boundary](openai-image-2.5.md#source-boundaries).
## Official examples to consult selectively
- [Translation with layout preservation](https://developers.openai.com/api/docs/guides/image-prompting?model=gpt-image-2.5#translate-while-preserving-layout)
- [Identity and clothing](https://developers.openai.com/api/docs/guides/image-prompting?model=gpt-image-2.5#preserve-identity-and-change-clothing)
- [Combining references](https://developers.openai.com/api/docs/guides/image-prompting?model=gpt-image-2.5#combine-references)
- [Transparent product cutouts](https://developers.openai.com/api/docs/guides/image-prompting?model=gpt-image-2.5#create-a-transparent-product-cutout)
- [Character consistency across turns](https://developers.openai.com/api/docs/guides/image-prompting?model=gpt-image-2.5#keep-a-character-consistent)
Improved preservation is not a pixel lock. Repeated edits can drift; exact
unchanged regions require compositing rather than relying on prompts alone.
[Official migration caution](https://developers.openai.com/api/docs/guides/image-prompting?model=gpt-image-2.5#migrate-an-existing-workflow)
## Local workflow using the existing CLI
1. Inspect the actual inputs. Assign each a role: base scene, identity, garment,
style or inserted object. Keep this order consistent with repeated `-i` flags.
2. Separate the requested change from invariants; do not turn a small edit into a
restyle. Consult [craft.md](craft.md) section 13 only if this needs clarification.
3. Keep the selected model explicit. Use [models.md](models.md#parameters) for
API settings; do not infer that 2.5 requires `--input-fidelity high`.
4. Compare the changed region and the rest of the image. For another authorized
edit, pass the actual approved output through `-i`; the CLI does not retain
a conversation or attach an image merely because its filename is in the prompt.
| Task | Inspect before accepting |
|---|---|
| Translation | Approved replacement copy, untranslated remnants, original layout and logos |
| Try-on / identity edit | Face, expression, pose, garment details and plausible body geometry |
| Multi-reference composition | Correct source for each inserted element, scale, perspective and lighting |
| Cutout | Product outline/labels, edge halos, hair/glass/shadows and real alpha transparency |
| Multi-step edit | Current requested change plus accumulated drift from the original invariants |
## Masks and transparent output
A mask is edit guidance, not a guaranteed hard pixel boundary. With multiple
inputs it applies to the first image. Match mask dimensions to that image and
check its alpha channel; use `-i` plus `-m`. See the
[official mask requirements](https://developers.openai.com/api/docs/guides/image-generation#edit-an-image-using-a-mask)
for input constraints.
For cutouts, use `--background transparent --format png` (or WebP), not JPEG.
Inspect the decoded alpha channel; a painted checkerboard is not transparency.
The prompt's preservation list alone does not establish that anything was
preserved. If the job requires exact untouched pixels, explain the need for a
separate compositing step; do not claim the generative edit supplies that guarantee.
For a reusable change-only prompt, read **Single-change preservation edit** in
[community templates](templates-gpt-image-2.5.md). API access and local output
validation remain governed by [models.md](models.md#validation-boundary).
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |