CommunityImagegithub.com

Envision

Réimaginez un lieu réel à partir de photos. Construit un profil de goût par projet à partir de toute inspiration (images, zip, dossier, Pinterest, noms de style, mots simples), éventuellement un mood board pour le valider, puis travaille espace par espace sur les photos réelles, générant des versions (avec ou sans meubles) et itérant avec l'utilisateur jusqu'à valider quelques images. Les moteurs d'images sont interchangeables (plan Codex/ChatGPT, API OpenAI, manuel ou tout adaptateur ajouté plus tard). À utiliser lorsque l'utilisateur souhaite rénover, redécorer ou imaginer une maison, une pièce, un jardin, une terrasse, un bureau, un magasin ou tout espace réel à partir d'une photo.

Qu'est-ce que Envision ?

Envision est une compétence d'agent IA conçue pour les architectes d'intérieur, décorateurs, agents immobiliers ou particuliers souhaitant réimaginer visuellement un espace réel. Elle fonctionne avec n'importe quel client d'agent (Claude Code, Codex, Cursor) capable d'exécuter des scripts shell et de manipuler des fichiers. La compétence vous guide (l'agent) dans un dialogue structuré : elle recueille les inspirations de l'utilisateur (images, liens, styles, notes vocales), construit un profil de goût écrit et validé, propose un mood board facultatif, puis lance des itérations espace par espace sur des photos réelles. Chaque round génère plusieurs versions – avec ou sans meubles – en s'appuyant sur un moteur d'image au choix (Codex/ChatGPT, API OpenAI, ou adaptateur personnalisé). La compétence insiste sur la fidélité au lieu réel : l'agent doit s'assurer que les proportions, les ouvertures et les éléments fixes restent inchangés. Le projet est organisé en dossiers et fichiers markdown, ce qui le rend traçable et réutilisable. L'architecture modulaire des moteurs (un fichier exécutable par moteur) permet d'ajouter facilement de nouveaux services d'IA générative.

Compatible avec✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/dtazi/envision/tree/HEAD

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

Que fait Envision ?

Une boucle de travail entre une personne et vous (le planificateur) pour voir ce qu'un lieu réel pourrait devenir. Restez léger : cet outil est conçu pour évoluer avec l'usage. Suivez la personne, pas ce fichier, lorsqu'elle veut quelque chose de différent ; ce sont des valeurs par défaut, pas des règles.

Les chemins ci-dessous sont relatifs au dossier de cette compétence (<skill>), que vous pouvez trouver à partir de l'endroit où vous lisez ce fichier.

0. Ouvrir ou démarrer un projet

  • Si le dossier actuel contient un project.md, c'est le projet : lisez-le, taste.md et le log.md de l'espace en cours, puis reprenez là où il s'est arrêté.
  • Sinon, demandez un nom de projet et créez le dossier (par défaut ~/Envision/<project>/, ou là où la personne le dit) avec cette structure, en créant les parties seulement lorsqu'elles sont nécessaires :
<project>/
  project.md        # ce qu'est le lieu, le choix du moteur, les espaces et leur état, les décisions
  taste.md          # le profil de goût écrit (validé par la personne)
  inspiration/      # tout ce que la personne a donné : images, dossiers décompressés, links.md, notes
  moodboard/        # facultatif, pour valider le goût
  place/            # plans, cartes, photos d'ensemble du lieu, le cas échéant
  spaces/<space>/
    originals/      # photos réelles de cet espace
    prompts/        # un fichier de prompt par rendu
    renders/        # sorties
    log.md          # chaque round : ce qui a été demandé, ce qui a été produit, ce que la personne a dit

Démarrez project.md à partir de <skill>/templates/project.md.

1. Brancher les outils (première fois dans un projet, ou sur demande)

Exécutez <skill>/scripts/doctor.sh. Il liste les moteurs d'image utilisables sur cette machine. Montrez la liste à la personne en termes simples et laissez-la choisir ; notez le choix dans project.md. Si celui qu'elle veut n'est pas prêt, guidez-la (l'en-tête de chaque adaptateur indique ce dont il a besoin). Ne demandez ni n'imprimez jamais de valeurs secrètes : les clés résident dans l'environnement shell de la personne.

Le planificateur, c'est vous, quelle que soit l'application qui a ouvert cette compétence (Claude Code, Codex...). Notion, ou tout autre endroit pour conserver une page de projet, est facultatif : si la personne le souhaite et qu'un connecteur est disponible, reflétez le brief, le goût et les images validées là-bas ; le dossier local reste la source de vérité.

2. Comprendre le goût

Prenez tout ce que la personne donne, dans n'importe quel mélange : images dans le chat, un zip ou un dossier, des tableaux ou épingles Pinterest, des liens, un style nommé ("hacienda espagnole", "japandi"), des notes vocales, du texte brut. Enregistrez le matériel dans inspiration/. Regardez chaque image ; pour les liens, lisez ce que vous pouvez atteindre et dites clairement ce que vous n'avez pas pu.

Écrivez taste.md à partir de <skill>/templates/taste.md : un résumé d'une ligne, puis ce qui revient souvent (matériaux, couleurs, lumière, meubles, plantes, ambiance), comment la personne vit dans l'espace (d'après ses mots), ce qu'elle ne veut PAS, et les questions ouvertes. Liez chaque affirmation à ses sources (par exemple "sols en terre cuite : 6 images sur 40 + dit explicitement"). Demandez ensuite à la personne de le corriger. C'est un fichier vivant : mettez-le à jour à chaque fois qu'un round vous apprend quelque chose ("rejette systématiquement les canapés blancs").

3. Mood board (facultatif)

Proposez-le ; ne le faites que si la personne souhaite valider le goût visuellement. Choisissez la voie la moins coûteuse qui répond à ce qu'elle demande : une sélection de ses propres images ou épingles (gratuit), des liens à regarder (gratuit), ou des images générées (coût/quota : dites-le d'abord). Enregistrez dans moodboard/ et notez dans taste.md ce qu'elle a validé ou rejeté.

4. Le lieu

S'il y a un plan, une carte ou un ensemble complet de photos, enregistrez-les dans place/ et écrivez dans project.md la liste des espaces et comment ils se connectent, afin que les versions restent cohérentes entre les pièces (même sol traversant, même palette). Sinon, travaillez espace par espace à partir des photos que la personne envoie. Créez spaces/<space>/ par espace et placez les photos originales dans originals/. Avant le premier rendu, décrivez ce qui est réellement là (murs, ouvertures, sol, plafond, lumière, ce qui mérite d'être conservé), afin que la personne puisse vous corriger.

5. Rounds

La personne demande quelque chose ("4 versions de la terrasse, sans meubles", "pareil mais avec un bar"). Pour chaque version :

  1. Écrivez le prompt dans spaces/<space>/prompts/<render-name>.txt. Partez de la demande de la personne et de taste.md ; passez 0 à 5 images d'inspiration comme références de style lorsqu'elles aident. Lorsque la version doit conserver le lieu réel, dites-le explicitement dans le prompt : mêmes murs, ouvertures, proportions, angle de caméra et cadrage ; nommez les éléments qui ne doivent pas bouger (un arbre, un escalier). Dites ce qui change et ce qui ne change pas.
  2. Choisissez l'image de base et dites à la personne laquelle : la photo réelle pour rester fidèle au lieu, ou un rendu précédent pour conserver ce qu'elle a aimé. Les gros changements reviennent généralement à la photo réelle ; les petites retouches peuvent s'appuyer sur un rendu.
  3. Rendu : <skill>/scripts/render.sh <engine> --base <img> --prompt <file> --out <png> [--ref <img>]... (les versions indépendantes peuvent s'exécuter en parallèle). Nommez les rendus de manière à ce qu'ils se trient et disent ce qu'ils sont, par exemple r2-03-no-furniture-bar.png.
  4. Regardez chaque résultat vous-même avant de le montrer. Dites honnêtement où il s'est éloigné du lieu réel (la caméra a bougé, un arbre a disparu). Envoyez les images dans le chat.
  5. Enregistrez le round dans log.md : la demande, chaque rendu avec sa base, ses références, son fichier de prompt et ce que vous voyez, puis la réaction de la personne.

La personne réagit : "garde ceci, jette cela, j'aime ces deux-là, plus dans cette direction". Intégrez-le dans le round suivant (et dans taste.md quand il s'agit de goût, pas de cet espace). Continuez jusqu'à ce que la personne valide quelques images. Marquez-les validated dans log.md et listez-les dans project.md, puis passez à l'espace suivant ou à la partie suivante de l'espace.

Moteurs

Chaque moteur est un exécutable dans <skill>/engines/ avec le même contrat (voir engines/README.md). Pour en ajouter un (une autre API, un modèle local, une application web pilotée manuellement), ajoutez un fichier là-bas ; rien d'autre ne change.

Skills associés