Vai alla guida all’uso
imagegendi OpenAI

ImageGen Skill.

Uno skill Claude Code e Codex per il lavoro con le immagini: genera o modifica immagini raster: illustrazioni, foto, texture, sprite, mockup.

  • Immagini e arte generativa
  • Image
openai/skills · skills/.system/imagegen/SKILL.mdSKILL.md
--- name: imagegen description: Generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos, illustrations, textures, sprites, mockups, or transparent-background cutouts. Use when Codex should create a brand-new image, transform an existing image, or derive visual variants from references, and the output should be a bitmap asset rather than repo-native code or vector. Do not use when the task is better … --- ## Top-level modes and rules ## When to use ## When not to use ## Decision tree ## Workflow ## Prompt augmentation
Metadati iniziali e intestazioni di sezione letti dal file upstream il 14/09/2026 · 16.170 caratteri in totale

01 Cosa fa

Cosa fa la Skill imagegen in Claude Code e Codex

Sintesi, workflow e output, tutto letto dal SKILL.md della skill.

Dal SKILL.mdLetto il 14-09-2026 · non è un'esecuzione registrata

Nelle parole della skill

Imagegen offre a Codex un workflow per immagini raster: generare o modificare asset bitmap come foto, illustrazioni, texture, sprite, mockup e ritagli con sfondo trasparente, per poi inserire il file finito nel progetto. Definisce due modalità di primo livello: lo strumento integrato preferito image_gen, che non richiede una chiave API, e un fallback CLI solo esplicito tramite scripts/image_gen.py che richiede OPENAI_API_KEY.

Il file separa l'intento (generare rispetto a modificare) dall'esecuzione (un asset o molti), raccoglie prompt, testo letterale, vincoli e immagini di input con ruolo etichettato, e li riorganizza in uno schema etichettato. Termina con la validazione rispetto a soggetto, stile, composizione e accuratezza del testo, iterazione a singola modifica e salvataggi non distruttivi.

Che cosa produce

  • Un'immagine bitmap prodotta tramite image_gen piuttosto che un placeholder SVG, HTML/CSS o canvas, ogniqualvolta l'utente abbia richiesto un asset in stile raster.
  • L'immagine finale selezionata spostata o copiata nel workspace, con qualsiasi codice o riferimento che la utilizza aggiornato per puntare a essa.
  • Un report conclusivo che indica il percorso finale di salvataggio di qualsiasi asset legato al workspace, il prompt finale e quale modalità l'ha prodotto.
  • Solo nel fallback CLI esplicito, gli artefatti finali scritti sotto output/imagegen/.
Vedi l'esempio di prompt ↗

Come funziona

  1. 01
    Scegliere prima la modalità di primo livello

    La generazione e la modifica normali passano attraverso lo strumento integrato image_gen; la CLI in bundle è un fallback che l'utente deve richiedere esplicitamente per nome.

  2. 02
    Classificare la richiesta come generazione o modifica

    Modificare un'immagine esistente mantenendone alcune parti è una modifica; fornire immagini puramente come riferimenti di stile, composizione o atmosfera è comunque una generazione.

  3. 03
    Decidere dove risiede l'output

    Il lavoro di anteprima o brainstorming può rimanere inline nella posizione predefinita, mentre tutto ciò che il progetto utilizza deve finire nel workspace.

  4. 04
    Raccogliere gli Input Prima di Generare

    Raccogliere in anticipo il prompt, l'eventuale testo esatto da inserire nell'immagine, i vincoli o la lista degli elementi da evitare e tutte le immagini di input, invece di riempire le lacune successivamente.

  5. 05
    Rimodellare il Prompt in una Specifica

    I prompt vengono normalizzati in una specifica strutturata e orientata alla produzione, invece di essere ampliati con dettagli creativi non richiesti.

  6. 06
    Emettere una Chiamata per Ogni Asset

    Nel percorso integrato, batch e varianti derivano da chiamate image_gen ripetute, una per ogni asset o variante richiesta, non da un unico flag di batch.

02 Trova la tua applicazione

Quando usare la skill imagegen

Usa la skill imagegen in Claude Code o Codex quando il lavoro riguarda immagini di questo tipo. Contesto e limiti sotto sono tratti dal file della skill stessa.

Buona applicazione

  • Produrre una bitmap completamente nuova, come concept art, uno scatto di prodotto, una cover o un'immagine hero per un sito web.
  • Generare una nuova immagine in cui le immagini fornite fungono solo da riferimento per stile, composizione o atmosfera.
  • Modificare un'immagine esistente per compiti come cambi di illuminazione o meteo, sostituzione dello sfondo, rimozione di oggetti, compositing o ritagli con sfondo trasparente.
  • Produrre molti asset o varianti per un singolo compito piuttosto che una sola immagine.

Conosci i limiti

  • Estendere o abbinare un set di icone SVG/vettoriali, un sistema di logo o una libreria di illustrazioni già esistente nel repo.
  • Forme semplici, diagrammi, wireframe o icone che è più efficiente costruire direttamente in SVG, HTML/CSS o canvas.
  • Piccole modifiche ad asset locali del progetto quando il file di origine esiste già in un formato nativo modificabile.
  • Qualsiasi compito in cui l'utente desidera chiaramente un output nativo di codice deterministico invece di una bitmap generata.

Cosa fornire

  • La richiesta principaleIl prompt primario dell'utente fornisce il soggetto e l'obiettivo, e viene riportato nella specifica come riga della richiesta principale.
  • Immagini di input con ruoli esplicitiOgni immagine fornita viene etichettata come immagine di riferimento, target di modifica o input di supporto per inserimento/stile/compositing prima della generazione.
  • Testo esatto e relativa tipografiaQualsiasi parola che deve apparire all'interno dell'immagine viene citata testualmente, con il carattere tipografico e il posizionamento specificati insieme ad essa.
  • Invarianti e lista degli elementi da evitarePer le modifiche, gli elementi che non devono cambiare vengono scritti esplicitamente, ad esempio modifica solo X mantenendo Y invariato.
  • Uso previsto dell'assetIndicare se l'immagine è una pubblicità, un mock di UI o un'infografica stabilisce la modalità e il livello di rifinitura a cui il prompt punta.

03 Dentro la skill

Le Regole che la Skill imagegen Fornisce a Claude Code e Codex

8 istruzioni concrete, valori predefiniti e limiti che il SKILL.md imposta per l'agente — la parte del file che cambia il risultato.

  1. Lo Strumento Integrato è il Predefinito

    Ogni normale richiesta di generazione o modifica passa attraverso lo strumento integrato image_gen, che non richiede OPENAI_API_KEY.

  2. Non Effettuare Mai il Downgrade Autonomamente

    L'agente non deve spostarsi autonomamente sul percorso CLI; quella scelta è sempre decisione dell'utente.

  3. CLI solo su richiesta

    Se l'utente sceglie la modalità CLI, utilizzare il workflow integrato scripts/image_gen.py e non scrivere runner SDK improvvisati.

  4. Lo script integrato è di sola lettura

    scripts/image_gen.py non viene mai modificato; se manca qualcosa, chiedere all'utente prima di fare qualsiasi altra cosa.

  5. Le risorse del progetto non possono rimanere in $CODEX_HOME

    Un file referenziato dal progetto deve essere spostato o copiato fuori dalla posizione predefinita delle immagini generate prima che l'attività sia terminata.

  6. Versionare piuttosto che sovrascrivere

    Le risorse esistenti vengono sostituite solo quando l'utente lo richiede esplicitamente; altrimenti il nuovo file riceve un nome affiancato con versione, ad esempio hero-v2.png.

  7. Preservare gli invarianti durante le modifiche

    Il lavoro di modifica blocca ciò che non deve cambiare e salva in modo non distruttivo invece di sovrascrivere la risorsa di origine.

  8. Nessuna gestione delle chiavi nel percorso integrato

    L'agente non chiede mai OPENAI_API_KEY durante l'uso di image_gen, né chiede all'utente di incollare una chiave completa nella chat.

04 Mettila al lavoro

Installa imagegen in Claude Code o Codex

Un comando npx skills add, poi un primo task nel tuo agente e una checklist per il risultato.

Aggiungi imagegen a Claude Code, Codex o al Tuo Agente

Eseguitelo nel Suo progetto; l'installer chiede a quale agente aggiungerlo.

Terminal
npx skills add https://github.com/openai/skills --skill imagegen

Forma CLI generica di skills per skills/.system/imagegen/SKILL.md; il repository può documentare un proprio percorso.

Assegna alla Skill un primo compito di lavoro con immagini

Adatta questo prompt con i tuoi contenuti e vincoli, poi eseguilo in Claude Code o Codex.

Example prompt
Use case: product-mockup Asset type: landing page hero Primary request: a minimal hero image of a ceramic coffee mug Style/medium: clean product photography Composition/framing: wide composition with usable negative space for page copy if needed Lighting/mood: soft studio lighting Constraints: no logos, no text, no watermark

Fonte: esempio SKILL.md (testuale).

Verifica il primo risultato

Ciò che il SKILL.md stesso indica come risultato corretto:

  • Verificare l'output rispetto a soggetto, stile, composizione, precisione del testo e agli invarianti, evitando gli elementi concordati in anticipo.
  • Procedere con una singola modifica mirata e riverificare, piuttosto che raggruppare più modifiche in un'unica iterazione.
  • Per le modifiche, ripetere gli invarianti a ogni iterazione affinché l'immagine non si allontani da ciò che doveva rimanere invariato.

In OpenDesign imagegen è integrato: Plugins → Skills, selezionarlo nella barra superiore.

05 Open source, tracciabile

Sorgente, licenza e verifica

Da dove provengono i dati di questa pagina e quando sono stati verificati l'ultima volta.

Author
OpenAI
Repository
github.com/openai/skills Branch main
File della skill
skills/.system/imagegen/SKILL.md Checksum del contenuto registrato alla verifica; commit 49f948f
License
Apache-2.0 Da skills/.system/imagegen/LICENSE.txt. Lo skill è open source; la generazione di immagini dipende ancora da un servizio ospitato.
Stelle del repository
27.129 Snapshot GitHub acquisita il 14/09/2026 per l'intero repository openai/skills. Non è un rating o un conteggio d'uso per imagegen.
Verificato da OpenDesign
14 settembre 2026 Il file sorgente, il percorso, il testo della licenza e il conteggio delle stelle sono stati verificati. Incluso nella build principale di OpenDesign (verificato il 28 agosto 2026); non è stata registrata un'esecuzione live su questa pagina.

All'interno di SKILL.md

  1. Modalità e regole di alto livelloimage_gen integrato è predefinito; il fallback CLI è esplicito solo su richiesta, con precedenza del percorso di salvataggio e limiti di sovrascrittura.
  2. Quando usarloNuove immagini, generazione guidata da riferimenti, modifiche di immagini esistenti e molte risorse o varianti.
  3. Quando non usarloSistemi vettoriali nativi del repository, forme native di codice, file nativi modificabili e output deterministico nativo di codice.
  4. Albero decisionaleSepara l'intento (generare rispetto a modificare) dalla strategia di esecuzione (una risorsa rispetto a molte).
  5. WorkflowDiciassette passaggi ordinati, dalla scelta della modalità alla costruzione del prompt, generazione, validazione e reportistica.
  6. Aumento del promptStruttura i prompt in una specifica di produzione, con aumenti consentiti e vietati collegati alla specificità.
  7. Taxonomy dei casi d'uso (slug esatti)Slug fissi di generazione e modifica per mantenere coerenza tra prompt e riferimenti.
  8. Schema di prompt condivisoCampi di scaffolding etichettati come tipo di asset, scena, soggetto, illuminazione, testo verbatim ed elenco degli elementi da evitare.
  9. EsempiUna spec per la generazione di un'immagine hero e una spec di modifica per la sostituzione dello sfondo che indica i suoi invarianti.
  10. Best practice per il promptingOrdine, citazione del testo esatto, indicizzazione di più immagini e iterazione con follow-up a modifica singola.
  11. Indicazioni per tipo di assetRimanda ai template per tipo di asset per lavori su sito web, gioco, wireframe e logo in sample-prompts.md.
  12. Solo modalità CLI di fallbackConvenzioni CLI per file temporanei e output, dipendenze uv e passaggi di configurazione di OPENAI_API_KEY.
Descrizione della skill
Genera o modifica immagini raster quando l'attività beneficia di visual bitmap creati con AI, come foto, illustrazioni, texture, sprite, mockup o ritagli con sfondo trasparente. Usa quando Codex deve creare un'immagine nuova, trasformare un'immagine esistente o derivare varianti visive da riferimenti, e l'output deve essere un asset bitmap piuttosto che codice nativo del repository o vettoriale. Non usare quando l'attività è meglio gestita modificando asset SVG/vettoriali/nativi in codice esistenti, estendendo un sistema di icone o loghi consolidato, o costruendo il visual direttamente in HTML/CSS/canvas.

Descrizione dal front-matter di SKILL.md. Il file completo è di circa 16.170 caratteri. Leggi il file completo su GitHub.

ImageGen

Esegui imagegen su un compito di lavoro con immagini reali.

Lo skill imagegen è incluso in OpenDesign. Scarica l'app, seleziona lo skill in Plugins → Skills, incolla il prompt qui sopra e leggi il piano prima del risultato.

Terminale
npx skills add https://github.com/openai/skills --skill imagegen