| 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
- Parser
$ARGUMENTS en variables (concept, options)
- Si concept vide : demander à l'utilisateur
- Détecter le style guide (ordre :
--style > cwd > active/<projet>/ > mode libre)
- 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
- 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) :
- Fidélité sémantique : L'idée est-elle bien comprise ? Si ambiguïté : clarifier avec l'utilisateur
- Traduction visuelle : Convertir concepts abstraits en éléments rendables
- Conformité style guide : Vérifier aucune contradiction (si style guide chargé)
- 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é)
- Passe simplicité : est-ce plus complexe que nécessaire ? Supprimer adjectifs redondants, détails microscopiques ignorés
- Style compression : injecter
prompt_core du style guide EN TÊTE de Prompt3 (si style guide chargé)
- 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
- Vérification tokens : compter les tokens estimés (~1.3 tokens/mot). Avertir si dépassement du max pour le niveau
- 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) :
- Annonce : Style guide utilisé (ou "Mode libre") + générateur + niveau
- Avertissements : faisabilité problématique, tokens élevés, etc. (s'il y en a)
- Prompt3 dans bloc code
- Prompt4 (si applicable) dans bloc code
- 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
- Score qualité (sur 10) : moyenne de style (conformité guide) / scène (traduction visuelle) / faisabilité (générateur accepte ?)
- 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é :
--style <nom-preset> : chercher dans presets/<nom>.json du skill (ex: --style orbital-fracture)--style <chemin> : chemin explicite vers un fichier JSONstyle-guide.json dans le répertoire de travail courant (pwd)- Recherche ascendante : remonter les répertoires parents jusqu'à trouver
style-guide.json (arrêt à ~/Claude/)
- 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
