imagegen

Rôle du skill imagegen

Ce skill fait partie des skills système (dossier .system) du repo officiel openai/skills, le catalogue de skills pour l'agent Codex d'OpenAI. Contrairement aux skills curated ou expérimentaux, les skills .system sont automatiquement installés dans toutes les instances récentes de Codex, sans action manuelle.

Son rôle est de donner à Codex une capacité structurée de génération et d'édition d'images raster (PNG, JPEG, sprites, mockups, textures, découpes sur fond transparent, etc.). Il couvre aussi bien la création d'une image de zéro que la transformation d'une image existante ou la production de variantes à partir d'images de référence.

Deux modes d'exécution

Le skill définit deux modes distincts et hiérarchisés :

• Mode par défaut — outil intégré image_gen : Codex utilise cet outil natif pour toutes les demandes courantes. Aucune clé API n'est requise dans ce mode.
• Mode CLI de secours (explicite uniquement) — scripts/image_gen.py : accessible uniquement si l'utilisateur le demande explicitement ou si l'outil intégré est indisponible. Ce mode nécessite une variable d'environnement OPENAI_API_KEY et expose trois sous-commandes : generate, edit et generate-batch.

Codex ne bascule jamais automatiquement vers le CLI ; il doit en informer l'utilisateur et attendre une confirmation explicite.

Ce que couvre le skill

Le SKILL.md embarque une documentation complète : arbre de décision pour choisir entre génération et édition, taxonomie des cas d'usage (product-mockup, ui-mockup, background-extraction, compositing, etc.), schéma de prompt structuré, règles de sauvegarde des fichiers dans le workspace, et guide d'augmentation des prompts. Des références complémentaires (references/prompting.md, references/sample-prompts.md, references/cli.md, etc.) complètent la documentation pour les deux modes.

Limites d'application

Ce skill n'est pas conçu pour étendre des systèmes d'icônes SVG existants, créer des formes simples mieux produites en HTML/CSS, ou générer tout type d'asset dont le format natif dans le repo est du code ou du vecteur éditable. Lorsque le résultat attendu est déterministe et code-natif, d'autres approches sont préférables.