Kit qualité Three.js — ressources, méthode, checklist
Ce skill répond à une question : qu'est-ce qui a fait passer nos vidéos Three.js de « primitives empilées » à un film
avec personnage riggé, vraie ville et mise en scène propre ? Trois choses : des ressources ajoutées au fil de l'eau,
une méthode de travail, et une relecture systématique. Le skill frère threejs-code-video contient le détail
technique (pipeline, personnage, caméra, boucles, pièges) ; celui-ci est la vue d'ensemble et le kit de démarrage.
Contenu
| Fichier | À quoi il sert |
|---|---|
| references/ressources.md | Inventaire complet : dépôts, skills, sites, outils, services — ce que chacun apporte, comment l'installer, licence |
| references/methode.md | La façon de faire, étape par étape, et les 6 leviers qui ont réellement monté la qualité |
| references/checklist.md | Checklist à cocher : installation, avant de coder, pendant, avant d'envoyer |
scripts/install-kit.js | Installe les skills publics du kit dans un projet (clone + copie, sans dépendance) |
scripts/planche.js | Vidéo → planche-contact (1 image/s) pour relire un rendu en entier |
scripts/polyfork-fetch.js | Cherche et télécharge des modèles Polyfork (modules .mjs paramétrables) |
scripts/face-landmarks.py, scripts/face-measure.py | Mesurer un visage sur photo (MediaPipe) au lieu de l'estimer à l'œil |
Les ressources en une minute
| Besoin | Ressource | Statut chez nous |
|---|---|---|
| Three.js à jour (r186), R3F, shaders, lumières… | 13 skills threejs-* — CloudAI-X/threejs-skills | installés, consultés à chaque composition |
| Rendu vidéo image par image | 8 skills Remotion — remotion-dev/skills | installés |
| Méthode + template vidéo en code | skill threejs-code-video + dépôt Alex-sia99/threejs-code-video | écrit par nous, public |
| Objets, décors, personnages low-poly | Polyfork (polyfork.dev, index lucas-martinic/polyfork-catalog) | utilisé dans le film v3 — modules .mjs jamais redistribués |
| Corps animé | squelette et clips Mixamo | corps riggé du film v3 |
| Ressemblance d'après photo | img2threejs/img2threejs + MediaPipe Face Landmarker | méthode « mesurer, pas estimer » adoptée |
| Images de référence avant de modéliser | Kie.ai nano-banana-2-lite | utilisé pour proportions et décors |
| Voix, effets, musique | ElevenLabs, Suno, FFmpeg | pipeline complet |
| Dessin 2D en code (autre style) | alexgreensh/anidoodle, html-anime | installés, hors Three.js |
Détail, liens et réserves : references/ressources.md.
La méthode en dix lignes
- Une référence avant tout : vidéo de style analysée en planche, images de référence, photo mesurée.
- Les skills avant le code : charger le skill
threejs-*ouremotion-*concerné, ne jamais écrire l'API de mémoire. - Étudier du bon code, puis réécrire : lire un module bien fait, noter la méthode, coder la sienne.
- Tout est une fonction pure du numéro d'image : graine fixe, marche par distance, aucun état accumulé.
- Script → voix → timeline : la mise en scène se cale sur les répliques (
at("l14")), jamais sur des secondes en dur. - Un atelier par problème : composition
Labpour le visage,RigLabpour le corps, rangée d'essais pour un doute. - Rendre, regarder, corriger : image fixe → planche par scène → vidéo finale relue à 1 image/s.
- Un audit sévère par un regard neuf avant toute refonte.
- Validation humaine tôt : le personnage et la direction de style avant le rendu long.
- Capitaliser : chaque piège rencontré va dans
pitfalls.md, chaque méthode dans un skill.
Détail : references/methode.md.
Règles non négociables
- Ne jamais envoyer un rendu non regardé. Une image fixe ne suffit pas pour un film : relire la vidéo finale en planche.
- Le style prime sur la précision. Un visage photo-réaliste dans un monde stylisé a été refusé deux fois ; la ressemblance passe par la forme et quelques traits nets.
- Respecter les licences. Polyfork : usage en vidéo libre, modules
.mjset clips cuits jamais dans un dépôt public ni dans un pack. - Un trait = un volume, un lieu = un objet reconnaissable, une réplique = un visuel qui la montre.
Transmettre le kit à un élève
Le kit est publié dans le dépôt https://github.com/Alex-sia99/threejs-quality-kit : il suffit d'envoyer ce lien. Le
README s'adresse à l'élève (prérequis, installation en 3 étapes, phrases à donner à son agent) ; install.js télécharge
lui-même les skills publics et le projet de départ, donc le dépôt reste léger et à jour. Ne jamais y ajouter de modules
Polyfork .mjs, de clips anim-*.json, de clé d'API, de photo ni de voix personnelle.