CommunityImagegithub.com

asset (ressources graphiques)

Génère des ressources graphiques finales pour le jeu (icônes, objets, arrière-plans, personnages, art de la boutique) avec le dernier modèle d'image GPT d'OpenAI, version 2 ou ultérieure, en respectant le style artistique existant du jeu.

Qu'est-ce que asset (ressources graphiques) ?

Cette compétence permet de générer des actifs image finaux (icônes, objets, arrière-plans, personnages, illustrations de la boutique) pour un projet de jeu, en utilisant le modèle d'image GPT d'OpenAI (version 2 ou ultérieure) pour correspondre au style artistique existant. Elle offre un processus structuré : vérification de l'activation de la génération d'images pour le projet (avec configuration de la clé API si nécessaire), planification des ressources (style, spécifications), génération via un script Python, inspection de chaque image avec jusqu'à trois régénérations si nécessaire, et un rapport final listant les actifs produits, leur emplacement, les éventuels drapeaux et le chemin du journal. La compétence supporte Claude Code et d'autres agents utilisant des répertoires de compétences, avec des commandes shell documentées. Elle gère la transparence, le redimensionnement (sans agrandir), et le logging de chaque génération. L'utilisateur peut également refuser la génération d'images pour un projet (option 'off') et continuer avec des placeholders ou des actifs existants.

Compatible avec✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/robson-work/gd-toolkit/tree/HEAD/skills/asset

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Ressources graphiques finales

<skill-dir> est le dossier qui contient ce SKILL.md, et <plugin-root> est deux dossiers au-dessus. Remplacez-les par les chemins réels dans les commandes. (Dans Claude Code, ce sont ${CLAUDE_SKILL_DIR} et ${CLAUDE_PLUGIN_ROOT}.)

Entrée : un actif ou une liste, comme "icône de gel de séquence" ou "les 6 icônes de récompense du GDD des quêtes quotidiennes". Sortie : PNG dans le dossier des actifs du jeu, chacun enregistré avec son prompt et son modèle.

Lisez d'abord <plugin-root>/shared/conventions.md et la configuration du dépôt (section Art).

GI="<skill-dir>/scripts/gen_image.py"   # Python 3 uniquement ; n'affiche jamais la clé
python3 "$GI" check                              # clé + modèle qui serait utilisé, sans coût (à exécuter depuis le dépôt du jeu)
python3 "$GI" generate --prompt "…" --out <fichier.png> [--size LxH] [--background transparent] [--ref <art.png> …] [--log <log.jsonl>]

0. La génération d'images est-elle activée pour ce projet ?

Lisez config : Génération d'images :

  • on : allez à l'étape 1.
  • off : ne générez pas. Utilisez l'art existant ou le modèle de remplacement du dépôt, et listez les actifs toujours nécessaires (nom, taille, utilisation) dans le rapport. Ne demandez pas à nouveau.
  • not set ou absent : c'est la première image pour ce projet. Exécutez check, puis demandez avec l'outil de question :
    • Si aucune clé n'a été trouvée, la question indique que les actifs finaux utilisent par défaut GPT Image d'OpenAI (la version la plus récente, 2 ou ultérieure) et qu'une clé API est nécessaire. Les options sont :
      1. Configurer une clé maintenant (Recommandé) : affichez les étapes de configuration ci-dessous et attendez que l'utilisateur confirme. Exécutez à nouveau check. Une fois prêt, écrivez on.
      2. Pas pour ce projet : écrivez off (opted out <AAAA-MM-JJ>) et continuez sans art généré.
      3. Pas maintenant : sautez les images cette fois, laissez le champ not set, et demandez à nouveau la prochaine fois.
    • Si une clé a été trouvée (dans le .env du dépôt, l'environnement, ou configurée pour un autre projet), la question indique où elle a été trouvée et le modèle que check a sélectionné. Si check indique que le fichier .env est suivi par git, prévenez que la clé est commitée et doit être tournée, et recommandez de la déplacer hors de git. Les options sont : l'utiliser pour ce projet (Recommandé, puis écrivez on), pas pour ce projet (off), et pas maintenant.

Configuration de la clé API (afficher à l'utilisateur)

  1. Allez sur platform.openai.com → API keys → Create new secret key. Une clé limitée à un projet est préférable.
  2. Assurez-vous que Billing a du crédit. Les modèles GPT Image peuvent également vous demander de vérifier votre organisation (Settings → Organization → General). L'accès peut prendre quelques minutes après la vérification.
  3. Enregistrez la clé sur cette machine. Ne la copiez jamais dans le chat.
    • macOS (recommandé) : exécutez ceci dans le Terminal. Il demande la clé sans l'afficher, et la stocke dans le Trousseau : security add-generic-password -U -a "$USER" -s gd-toolkit-openai -w
    • Ce projet uniquement : ajoutez OPENAI_API_KEY=… au fichier .env ou .env.local du dépôt. Vérifiez d'abord que le fichier est dans .gitignore.
    • Partout : ajoutez export OPENAI_API_KEY=… à votre profil shell, par exemple ~/.zshrc, puis ouvrez un nouveau terminal.
    • Ou utilisez un fichier lisible uniquement par vous : ~/.config/gd-toolkit/openai_api_key (chmod 600).
  4. Dites-moi quand c'est fait, et je le vérifierai. Cette vérification ne coûte rien.

Une clé dans le Trousseau, le shell ou le fichier de configuration fonctionne pour tous les projets ; une clé dans .env fonctionne pour son dépôt et a priorité sur le Trousseau. Le choix on/off est fait par projet.

1. Planifier les actifs

  • Style : lisez config : Style artistique et regardez l'art de référence qu'il liste. Passez 1 à 4 des actifs existants les plus proches en tant que --ref, afin que le nouvel art corresponde au jeu. Décrivez le style dans chaque prompt avec les mêmes mots : palette, épaisseur de trait, ombrage, angle de caméra et matériau.
  • Spécifications : pour chaque actif, sa taille finale, son format, s'il nécessite de la transparence, son nom de fichier et son chemin (config : Dossier des actifs, plus le modèle de nommage du dépôt).
  • Affichez la liste, avec son nombre total et son modèle, et générez une fois que l'utilisateur l'approuve. Une seule confirmation couvre le lot.

2. Générer

  • Modèle : --model auto (par défaut) utilise le modèle gpt-image le plus récent, version 2 ou ultérieure, que la clé peut utiliser, en privilégiant la variante détaillée pour l'art final. --fast (passé en tant que --prefer fast) est pour les brouillons uniquement. Si config : Modèle d'image nomme un modèle, passez-le avec --model.
  • Taille : générez à la plus grande taille carrée du modèle ou au rapport d'aspect le plus proche, puis réduisez aux tailles finales (sips -Z <px> sur macOS). N'agrandissez jamais.
  • Transparence : les icônes, objets et sprites nécessitent --background transparent. Si la sortie indique que le modèle l'a rejeté, l'image a été rendue opaque : régénérez avec une couleur d'arrière-plan plate et unie nommée dans le prompt, supprimez cette couleur, et mentionnez-le dans le rapport.
  • Prompt : décrivez le sujet, puis le bloc de style, puis la composition (centré, espacement, pas de texte sauf demande explicite). Demandez l'absence de mots, logos ou filigranes, sauf si l'actif nécessite du texte.
  • Enregistrez chaque génération dans config : Journal des actifs (--log). Ne placez jamais de fichiers de métadonnées à côté des actifs livrés.

3. Vérifier chaque image

Examinez chaque image avant de la conserver, en utilisant une petite copie pour économiser du contexte. Régénérez-la, au maximum 3 fois, si elle ne correspond pas aux références de style, comporte du texte ou des artefacts parasites, est mal recadrée, ou est illisible à sa plus petite taille dans le jeu. Si elle échoue encore, gardez la meilleure et signalez-la.

4. Rapporter

Listez chaque actif avec son chemin, ses tailles, son modèle et les éventuels drapeaux. Donnez également les actifs encore nécessaires (si la génération est off ou a été sautée), et le chemin du journal. Dites que les images sont générées par IA, afin que le propriétaire puisse décider où cela doit être divulgué, par exemple sur les fiches de la boutique.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills associés