prompt-image

name	prompt-image
version	1.0.0
description	Pipeline de raffinement progressif pour prompts image. Transforme une idée brute en prompt optimisé, contraint par un style guide et adapté au générateur cible. Inspiré de DeepPrompter.
allowed-tools	Read, Write, Edit, Glob, Grep, Bash
argument-hint	[description de l'image] [--gen nano-banana|qwen] [--style chemin] [--intent editorial|cover|thumbnail|hero|storytelling|infographic] [--niveau 1-4] [--verbose]
context	conversation

Skill : /prompt-image

Déclencheurs

• /prompt-image <idée> — transformation idée brute → prompt image
• /prompt-image --gen qwen Un chat assis — avec générateur explicite
• /prompt-image --style /path/to/style-guide.json ... — avec style guide externe
• Toute demande de raffinement de prompt image

Arguments et options

Option	Valeurs	Défaut	Description
Concept brut	texte libre	(obligatoire)	Idée à transformer en prompt
--gen	nano-banana, qwen	auto-détecté	Générateur cible
--style	nom preset ou chemin	auto-détecté	Preset par nom (orbital-fracture, ligne-claire-plus) ou chemin vers un style-guide.json
--intent	editorial, cover, thumbnail, hero, storytelling, infographic	auto	Contexte d'utilisation
--niveau	1, 2, 3, 4	auto	Complexité du prompt (sinon détecté)
--verbose	(flag)	false	Afficher Prompt1, Prompt2 (debug)

Périmètre

Couvert :

• Transformation d'idées brutes en prompts image prêts à copier-coller
• Support Nano Banana 2 et Qwen-Image 2.0 (extensible)
• Mode libre (sans style guide) et mode avec contraintes (style guide JSON)
• Itération sur le résultat via feedback utilisateur
• Mode debug --verbose pour inspect des prompts internes

Hors périmètre :

• Exécution de code ou appels API (texte uniquement)
• Génération réelle d'images
• Autres générateurs (v2+)

---

Workflow principal

Étape 0 : Parsing et détection

1. Parser $ARGUMENTS en variables (concept, options)
2. Si concept vide : demander à l'utilisateur
3. Détecter le style guide (ordre : --style > cwd > active/<projet>/ > mode libre)
4. Charger via Read :
   • Style guide JSON (si trouvé) → vérifier schema_version + clés obligatoires
   • Reference du générateur cible (references/nano-banana-2.md ou references/qwen-image-2.md)
   • references/methode-raffinement.md pour l'arbre de décision du niveau
5. Annoncer la configuration (style guide utilisé, générateur, niveau détecté)

Avertissements ou confirmations :

• Genre custom du style guide → signaler et demander confirmation
• Conflit entre paramètres → clarifier avec l'utilisateur

Étape 1 : Analyse (interne)

Appliquer les 4 passes de vérification selon le niveau détecté (voir methode-raffinement.md pour les critères) :

1. Fidélité sémantique : L'idée est-elle bien comprise ? Si ambiguïté : clarifier avec l'utilisateur
2. Traduction visuelle : Convertir concepts abstraits en éléments rendables
3. Conformité style guide : Vérifier aucune contradiction (si style guide chargé)
4. Faisabilité générateur : Signaler les éléments que le générateur gère mal (mains, groupe 5+, texte, etc.)

Si faisabilité problématique : avertissement utilisateur, mais continuer (pas de blocage)

Étape 2 : Prompt1 (interne)

Décomposer le concept en 10 clés fixes (non exposées sauf --verbose) :

subject | action | setting | style | camera | lighting | color | composition | materials | detail_density

• Remplir chaque clé avec les éléments identifiés par l'analyse
• Si style guide chargé : verrouiller les clés fixes (genre, format, rendering, positioning) et marquer [VERROUILLÉ]
• Langue : anglais

Étape 3 : Prompt2 (interne)

Enrichir le Prompt1 avec :

• Détails de scène (objets, arrière-plan, éléments d'ambiance)
• Matériaux et textures
• Atmosphère narratifs
• Détails de personnage (expressions, vêtements, accessoires)

RÈGLE CRITIQUE : ne JAMAIS introduire de nouvel attribut de style. L'enrichissement ajoute UNIQUEMENT scène/matériaux/atmosphère.

Si style guide chargé : vérifier que les familles de couleurs et moods ajoutées appartiennent aux listes autorisées.

Termes interdits : vérifier qu'aucun terme de methode-raffinement.md section « termes interdits » n'apparaît.

Étape 4 : Prompt3 + Prompt4 (exposés)

Prompt3 (prompt positif optimisé)

1. Passe simplicité : est-ce plus complexe que nécessaire ? Supprimer adjectifs redondants, détails microscopiques ignorés
2. Style compression : injecter prompt_core du style guide EN TÊTE de Prompt3 (si style guide chargé)
3. Formatage selon générateur :
   • Nano Banana 2 : 5 blocs (sujet | contexte/scène | style visuel | caméra/lumière | contraintes finales). Voir nano-banana-2.md pour structure exacte et suffixes
   • Qwen-Image 2.0 : 7 règles (sujet d'abord, général→spécifique, texte entre guillemets, contraintes négatives, relations spatiales, suffixes qualité, style vs contenu). Voir qwen-image-2.md pour structure exacte et suffixes
4. Vérification tokens : compter les tokens estimés (~1.3 tokens/mot). Avertir si dépassement du max pour le niveau
5. Afficher Prompt3 dans un bloc ```txt prêt à copier-coller

Prompt4 (prompt négatif ou conversion)

• Nano Banana 2 : Pas de champ négatif natif → convertir les interdictions en formulations positives (voir tableau conversion nano-banana-2.md). Si conversion impossible → avertir l'utilisateur
• Qwen-Image 2.0 : Supporte prompt négatif explicite. Construire à partir de negative_core du style guide (si existant) + termes auto-déduits des avoid et de la faisabilité
• Afficher Prompt4 dans un bloc ```txt ou section dédiée

Étape 5 : Exposition et checklist

Afficher à l'utilisateur (en français) :

1. Annonce : Style guide utilisé (ou "Mode libre") + générateur + niveau
2. Avertissements : faisabilité problématique, tokens élevés, etc. (s'il y en a)
3. Prompt3 dans bloc code
4. Prompt4 (si applicable) dans bloc code
5. Checklist de conformité (tableau 2 colonnes : critère | OK/N/A)
   • Pour Nano Banana 2 : structure 5 blocs, formulations positives, pas groupe 5+, mains gérées, tokens < max
   • Pour Qwen : 7 règles, sujet en tête, guillemets, spatial décrit, suffixes, séparation style/contenu
   • Pour style guide : prompt_core injecté (si applicable), aucun terme avoid présent, palette respectée, mood autorisée
6. Score qualité (sur 10) : moyenne de style (conformité guide) / scène (traduction visuelle) / faisabilité (générateur accepte ?)
7. 3 options créatives contextuelles (exemples : monter de niveau, changer style, modifier composition, variante d'éclairage)

Étape 6 : Itération

L'utilisateur peut :

• Valider (fin du workflow)
• Modifier un paramètre ("plus de contraste", "change l'intent", "--niveau 4")
• Changer de générateur (--gen qwen au lieu de nano-banana)
• Demander une variante ("version plus surréaliste", "pose alternative")

Retour à l'étape 4 (ou étape 1 si modification majeure du concept).

---

Décisions d'implémentation

Auto-détection du niveau

Si --niveau non spécifié, utiliser l'arbre de décision de methode-raffinement.md :

Le concept mentionne un layout/grille/zones précis ?
  → OUI + texte à rendre → niveau 4
  → OUI sans texte → niveau 3
  NON : type design explicite (poster, PPT, BD, infographie) ?
    → OUI → niveau 3
    NON : 3+ éléments distincts ou style identifiable ?
      → OUI → niveau 2
      NON → niveau 1

Auto-détection du générateur

Si --gen non spécifié :

• Défaut : Nano Banana 2 (générateur générique, bien supporté)
• Si mention de "texte à rendre" ou "multi-panneaux" : Qwen (meilleur support texte et layouts)
• Proposer alternative si choix semble sous-optimal

Auto-détection de l'intent

Si --intent non spécifié, inférer du contexte :

• "affiche" / "poster" → editorial ou hero
• "vignette" / "petit" → thumbnail
• "illustration" / "histoire" → storytelling
• "infographique" / "diagram" → infographic
• Défaut : editorial

Mode verbose

Si --verbose : afficher aussi Prompt1 et Prompt2 entre les étapes. Aider au debug et à la compréhension du raffinement interne.

---

Références documentaires

Le skill oriente l'utilisateur vers les fichiers de référence pour les détails :

Fichier	Utilisation
methode-raffinement.md	Détail des 4 passes, arbres de décision, critères faisabilité, termes interdits
schema-style-guide.md	Contrat JSON d'un style guide, clés obligatoires, types, exemples
nano-banana-2.md	Structure 5 blocs, suffixes, faiblesses, conversions positives, termes photo/cinéma
qwen-image-2.md	7 règles, capacités avancées, texte multi-surface, modes d'édition, paramètres techniques

---

Contraintes

• Français + anglais : interface en français, prompts en anglais
• Pas d'emojis : résultats professionnels
• Pas de code : texte uniquement
• Validation style guide : charger + vérifier schema_version et clés obligatoires via Read. Si invalide : avertissement explicite, mode dégradé possible
• Pas de hallucination : ne jamais inventer de références générateur. Si doute : consulter les fichiers de référence (via Read)
• Itération infinie interdite : max 3 retours à l'étape 4. Au-delà : proposer de sauvegarder le meilleur effort et relancer une nouvelle session

---

Implémentation

Le skill est un orchestrateur : il lit les références via Read et applique la logique du pipeline. Il ne duplique pas les détails (ils vivent dans les fichiers de référence). Les modifications futures au pipeline viennent de la mise à jour des fichiers de référence, pas du SKILL.md lui-même.

Vérification des tokens

L'estimation des tokens est LLM-native : compter les mots du Prompt3 et multiplier par ~1.3. Pas d'outil externe. Seuils max par niveau et générateur définis dans les fichiers reference (nano-banana-2.md et qwen-image-2.md). Si dépassement : avertissement à l'utilisateur, pas de blocage.

Résolution du style guide

Recherche séquentielle, premier trouvé utilisé :

1. --style <nom-preset> : chercher dans presets/<nom>.json du skill (ex: --style orbital-fracture)
2. --style <chemin> : chemin explicite vers un fichier JSON
3. style-guide.json dans le répertoire de travail courant (pwd)
4. Recherche ascendante : remonter les répertoires parents jusqu'à trouver style-guide.json (arrêt à ~/Claude/)
5. Mode libre si rien trouvé -- annoncer explicitement

Presets disponibles

Lister les presets : ls presets/ dans le répertoire du skill.

Preset	Genre	Usage
ligne-claire-plus	Ligne claire franco-belge rehaussée	Feuilletons éditoriaux, illustrations LinkedIn, séries narratives
orbital-fracture	Geometrie orbitale fracturee, luminescence chirurgicale, void hostile	Posters scientifiques, covers tech, visualisations data, branding deeptech
bio-lumina	Bioluminescence organique, architecture vegetale nocturne, pulsation vivante	Illustrations nature-tech, covers biotech, visuels nocturnes, branding organique
flat-design	Illustration vectorielle minimaliste	Slides, infographies, dashboards, illustrations corporate, icones
whiteboard-sketch	Diagramme whiteboard premium, faux-handmade controle, palette semantique	Blog engineering, docs techniques, explainers, posts LinkedIn, schemas architecture

Pour ajouter un preset : créer un fichier presets/<nom>.json conforme au schéma L0 (references/schema-style-guide.md).

Correspondance étapes / prompts

Étape	Nom	Prompt produit	Visibilité
0	Parsing et détection	--	Annonce config
1	Analyse	--	Interne (avertissements exposés)
2	Décomposition	Prompt1 (10 clés)	Interne (sauf --verbose)
3	Enrichissement	Prompt2	Interne (sauf --verbose)
4	Optimisation	Prompt3 + Prompt4	Exposé
5	Itération	--	3 options + feedback

---

Pièges courants

Piège	Symptôme	Contournement
Style guide JSON invalide	Erreur au chargement, clés manquantes	Vérifier avec le schéma L0 (schema-style-guide.md). Le template commenté est dans ce fichier
Concept trop vague ("une belle image")	Prompt générique, score scène bas	Demander à l'utilisateur de préciser : sujet, contexte, ambiance. Minimum 3 éléments concrets
Confusion Nano Banana vs Qwen	Prompt formaté pour le mauvais générateur	Vérifier --gen. Par défaut Nano Banana. Si texte à rendre ou layout complexe : recommander Qwen
Groupe de 4+ personnages	Visages déformés, expressions perdues	Avertir via la passe faisabilité. Recommander plan large ou réduction à 3 personnages
Enrichissement qui casse le style	Termes comme "dramatic lighting" ajoutés en Prompt2	Vérifier contre la liste des termes interdits dans methode-raffinement.md

---

Dernière mise à jour : 7 avril 2026
Version : 1.1.0
Statut : Production