objets-3d
Skill3 starsChanged 9 days agoMITView on GitHub
Crée les objets 3D du site dans Blender, par script et sans interface — produit du client (flacon, boîte, bouteille, objet), décor, pièces animées — lisses et éclairés comme une vraie photo de studio, puis en tire les photos du catalogue, les animations au défilement (séquence d''images, vidéo) et le .glb pour la 3D en direct. Boucle de correction automatique (agent client neuf, note sur 100) avant de montrer, puis validation de l''utilisateur avant les rendus finaux. Appelé par les étapes médias, maquette et construction de Lance ton site.
In this repository15 other files it gives its agents.
- commun/agents.mdAGENTS.md
- architectureSkill
- cadrageSkill
- charteSkill
- construireSkill
- contenusSkill
- demarrerSkill
- deployerSkill
- design-systemSkill
- maquetteSkill
- marqueSkill
- mediasSkill
- passationSkill
- prdSkill
- statutSkill
The file
Files
Objets 3D (Blender)
Lire d'abord ${CLAUDE_PLUGIN_ROOT}/commun/conventions.md et
${CLAUDE_PLUGIN_ROOT}/commun/parcours.md (rythme, porte de validation). Tout ce qui suit se fait en entier.
Le connecteur blender, en plus du script
La voie par défaut reste le script sans interface : elle se rejoue et ne demande rien d'ouvert. Le MCP blender (serveur officiel du Blender Lab, v1.0.3) sert à regarder et retoucher une scène ouverte, à inspecter un .blend reçu et à consulter le manuel et l'API de Blender. Lire references/connecteur-blender.md avant de s'en servir : mise en place, outil par moment, règles pour le code envoyé.
- Sans rien installer :
search_api_docs,get_python_api_docsetsearch_manual_docsrépondent même Blender fermé. Les consulter avant d'écrire unbpyincertain, y compris pour les scriptslib3d. - Scène ouverte : il faut Blender 5.1 ou plus récent, le module MCP et l'accès en ligne de Blender. Rien de cela ne s'installe sans un oui ; sans eux, la voie par script fait tout le travail.
execute_blender_codeexécute du Python sans garde-fou et passe en dernier recours : faire enregistrer le fichier avant, et n'envoyer que du code écrit ici.
La règle : ne pas hésiter, et passer par Blender
Dès qu'un site gagne à montrer un objet (un produit, un contenant, un outil, une pièce, une matière), faire la 3D sans attendre qu'on la demande. Un objet 3D bien fait sert trois fois : photos du catalogue (toutes cohérentes, tous les angles), animation de page (l'objet tourne, s'ouvre, s'assemble au défilement) et 3D en direct.
Blender d'abord, par script Python (bpy) lancé sans interface : le script se rejoue à
l'identique pour chaque variante, suit les cotes réelles, et Cycles calcule la réfraction du verre
et des liquides. Les autres voies ne viennent qu'en appoint :
| Objet | Voie | Pourquoi |
| Le produit du client, son contenant, son logo | Blender, modélisé sur mesure (references/modelage.md) | c'est le sien : cotes, étiquette et logo exacts |
| Objet générique sans marque (plante, pierre, meuble, outil) | bibliothèque libre CC0 / CC-BY (references/bibliotheques.md), reprise dans Blender | plus rapide, qualité scan |
| Forme organique impossible à modéliser par script | image → 3D (fal), payant, sur le budget IA, coût annoncé, reprise dans Blender | appoint |
| Décor abstrait léger (particules, vagues, formes simples) | three.js en code | pas besoin de Blender |
Mise en place
bash ${CLAUDE_PLUGIN_ROOT}/skills/objets-3d/scripts/installer-blender.sh: trouve Blender. S'il manque, demander le oui (environ 1 Go, gratuit) puis relancer avec--installer. Sans oui : pas de Blender. L'objet passe par une photo fournie et sa liste de prises de vue, et le manque se dit à la porte.- Lancer Blender avec le chemin donné par l'installateur (
BLENDER=…, il n'est pas toujours dans le PATH), dans un appel Bash sans bac à sable (dangerouslyDisableSandbox: true), sinon il plante au démarrage (code 139) :"$BLENDER" -b --factory-startup --python objet.py -- <arguments>. - Partir de
${CLAUDE_PLUGIN_ROOT}/skills/objets-3d/scripts/exemple.py: le flacon Ciste complet (verre, jus, étiquette papier, bague moletée, bouchon), réglé en 4 tours de boucle. Changer profils, matières, étiquette et couleurs. La bibliothèquescripts/lib3d.pyfournit formes lisses, matières, étiquette, studio photo, appareil, rendu, animation, export. Étiquette : image rendue depuis le HTML de la charte avec Playwright (modèle :${CLAUDE_PLUGIN_ROOT}/skills/maquette/templates/exemples/commerce-flacon/outils/blender/etiquettes.cjs). - Ranger dans le projet :
06-medias/3d/(scripts,.blendsi utile), rendus dans06-medias/3d/rendus/,.glbdans06-medias/3d/(seul chemin source ; copié danssite/modeles/à la construction).
Les étapes
- Brief objet (5 lignes) : quoi, cotes réelles (ou
[hypothèse]déduites d'une photo), matières, couleurs de la charte, où il servira (fiche 4:5, hero 16:9, animation, 3D en direct), ce qu'il doit dire (marque02-marque.md). - Modéliser :
references/modelage.md. Toujours lisse (profil en splineadoucir, 192 pas, ombrage lisse), aucune arête vive, épaisseurs réelles, liquide qui déborde dans le verre, étiquette et logo rendus depuis le HTML de la charte (Playwright), logo en graisse forte. - Studio :
eclairage_produit()+cyclo()+appareil()(references/lumiere-studio.md). - Contrôle, puis aperçu :
scripts/controle_scene.py(facettes, matières, normales, images, poids) ; corriger chaque défaut, puis rendre à 720 px de large, 96 échantillons (30 s à 1 min de rendu). - Boucle de correction automatique (
references/boucle-3d.md) : se relire, puis un agentclient-personaneuf à chaque tour, en mode « élément 3D », note sur 100 ; corriger, re-rendre. Jusqu'à 85 et « je paierais », 3 tours au plus. Pas d'image montrée avant la fin de la boucle, mais un point d'avancement d'une ligne par tour (note, ce qui est corrigé). - Porte de validation : montrer l'aperçu, la note et son évolution, ce qui reste en
hypothèse, puis
AskUserQuestion: Valider et lancer les rendus finaux / Modifier, avec la taille des rendus : 1080 px pour le site (recommandé, environ 5 min de rendu par image), 2048 px pour un zoom ou 3072 px pour l'impression (25 min et plus de rendu par image). Jamais de 4K par défaut. Jamais de rendu final sans un oui explicite. Cette porte est propre au skill (exception prévue dans${CLAUDE_PLUGIN_ROOT}/commun/parcours.md§ 4) : elle ne remplace pas celle de l'étape appelante. - Rendus finaux (en tâche de fond) : photos à la taille choisie (1080 px par défaut),
256 échantillons.
optimiser-medias.shexclut3d/rendus: copier les rendus choisis dans06-medias/images/, puis lancer${CLAUDE_PLUGIN_ROOT}/skills/medias/scripts/optimiser-medias.sh(AVIF + WebP, plusieurs largeurs) ; animations selonreferences/animations.md(séquencecanvas[data-sequence]par défaut,scripts/sequence.sh) ;.glbavecexporter_glb()vers06-medias/3d/: cible 500 Ko, plafond 3 Mo (le plafond est celui de l'étape médias ; au-delà, alléger le modèle). - Intégrer et vérifier dans le navigateur (desktop, mobile, mouvement réduit) : l'image de repos est la face avant, la séquence ne saute pas, le poids reste raisonnable.
- Séquences :
sequence.shécrit directement dans le dossierimages/du site (pas dans06-medias/, queoptimiser-medias.shbalaie et décline en tailles). - Manifeste
06-medias/medias.md: chaque rendu (script, réglages, note de la boucle), chaque modèle tiers (source, auteur, licence, lien). - Revenir à l'étape appelante (médias, maquette ou construction) : sa propre porte de
validation reste celle de
${CLAUDE_PLUGIN_ROOT}/commun/parcours.md§ 4.
Avant la porte
Appelé depuis une étape (médias, maquette, construction) : cette section ne s'applique pas. La boucle automatique sur une image et la porte de l'objet (étapes 5 et 6) restent ; le contrôle d'étape et la porte sont ceux de l'étape appelante.
Lancé seul (/lancetonsite:objets-3d), après les rendus finaux, cocher d'après les fichiers :
06-medias/3d/: le script qui rejoue l'objet, ou la source et la licence du modèle tiers.06-medias/3d/boucle/tour-N/scores.md: 85 et « je paierais » au dernier tour, sinon la note et ce qui bloque.06-medias/3d/rendus/: chaque rendu à la taille validée, sans facette ni arête vive ; ceux retenus sont copiés dans06-medias/images/et optimisés dans06-medias/web/.- Le
.glb, s'il est prévu, dans06-medias/3d/: 3 Mo au plus. L'animation, s'il y en a une, finit face avant, logo visible, avec son image fixe de repli. 06-medias/medias.md: une ligne par rendu (script, réglages, note de la boucle) et par modèle tiers (source, auteur, licence, lien).
Puis le contrôle d'étape, en étape 6 : ${CLAUDE_PLUGIN_ROOT}/commun/boucle-persona.md, « Le contrôle d'étape ». Puis la
porte de ${CLAUDE_PLUGIN_ROOT}/commun/parcours.md § 4.
Références
references/modelage.md: cotes, techniques, règles de finition, matières, export.references/lumiere-studio.md: le schéma de lumière, les erreurs et leurs causes, réglages.references/animations.md: séquence d'images, vidéo,.glbanimé, branchement au kit.references/boucle-3d.md: la boucle de correction et la grille sur 100, la porte de validation.references/bibliotheques.md: modèles gratuits et libres (Poly Haven, ambientCG, Smithsonian…).references/connecteur-blender.md: le MCP officiel, outil par moment, règles pour le code envoyé, contrôle de scène.references/outils-et-sources.md: outils, extensions, licences, sources.
Ce qu'on ne fait pas
- Montrer un rendu qui n'est pas passé par la boucle, ou lancer les rendus finaux sans oui.
- Des facettes, une arête vive, un « on voit que c'est de la 3D faite vite ».
- Générer par IA l'image d'un produit qui porte un texte (étiquette fausse) : on le modélise.
- Télécharger un modèle sans le oui de l'utilisateur, ou sans noter sa licence.
- Une animation qui finit ailleurs que face avant ; une animation sans image fixe de repli.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

