Communitygithub.com

threejs-quality-kit

Kit qualité pour les vidéos Three.js en code : ressources, méthode et checklist pour passer de primitives à un film abouti.

Qu'est-ce que threejs-quality-kit ?

Ce skill rassemble l'ensemble des ressources et de la méthodologie qui ont permis de passer des vidéos Three.js basiques à des productions soignées (personnages riggés, décors urbains, mise en scène). Il inventorie tous les dépôts, bibliothèques d'assets, outils de mesure et services audio utilisés, et détaille la méthode de travail en dix étapes : partir d'une référence visuelle, charger les skills adaptés, étudier du code existant, travailler avec des fonctions pures, caler la timeline sur les répliques, résoudre chaque problème dans un atelier dédié, puis relire et valider. Le kit comprend également une checklist à cocher et un script d'installation pour transmettre l'ensemble à un élève. Compatible avec Claude Code, Cursor, Codex et tout agent capable de lire les fichiers `.md` et de lancer des scripts Node/Python.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Alex-sia99/threejs-quality-kit/tree/HEAD/skills/threejs-quality-kit

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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.mdInventaire complet : dépôts, skills, sites, outils, services — ce que chacun apporte, comment l'installer, licence
references/methode.mdLa façon de faire, étape par étape, et les 6 leviers qui ont réellement monté la qualité
references/checklist.mdChecklist à cocher : installation, avant de coder, pendant, avant d'envoyer
scripts/install-kit.jsInstalle les skills publics du kit dans un projet (clone + copie, sans dépendance)
scripts/planche.jsVidéo → planche-contact (1 image/s) pour relire un rendu en entier
scripts/polyfork-fetch.jsCherche et télécharge des modèles Polyfork (modules .mjs paramétrables)
scripts/face-landmarks.py, scripts/face-measure.pyMesurer un visage sur photo (MediaPipe) au lieu de l'estimer à l'œil

Les ressources en une minute

BesoinRessourceStatut chez nous
Three.js à jour (r186), R3F, shaders, lumières…13 skills threejs-* — CloudAI-X/threejs-skillsinstallés, consultés à chaque composition
Rendu vidéo image par image8 skills Remotion — remotion-dev/skillsinstallés
Méthode + template vidéo en codeskill threejs-code-video + dépôt Alex-sia99/threejs-code-videoécrit par nous, public
Objets, décors, personnages low-polyPolyfork (polyfork.dev, index lucas-martinic/polyfork-catalog)utilisé dans le film v3 — modules .mjs jamais redistribués
Corps animésquelette et clips Mixamocorps riggé du film v3
Ressemblance d'après photoimg2threejs/img2threejs + MediaPipe Face Landmarkerméthode « mesurer, pas estimer » adoptée
Images de référence avant de modéliserKie.ai nano-banana-2-liteutilisé pour proportions et décors
Voix, effets, musiqueElevenLabs, Suno, FFmpegpipeline complet
Dessin 2D en code (autre style)alexgreensh/anidoodle, html-animeinstallés, hors Three.js

Détail, liens et réserves : references/ressources.md.

La méthode en dix lignes

  1. Une référence avant tout : vidéo de style analysée en planche, images de référence, photo mesurée.
  2. Les skills avant le code : charger le skill threejs-* ou remotion-* concerné, ne jamais écrire l'API de mémoire.
  3. Étudier du bon code, puis réécrire : lire un module bien fait, noter la méthode, coder la sienne.
  4. Tout est une fonction pure du numéro d'image : graine fixe, marche par distance, aucun état accumulé.
  5. Script → voix → timeline : la mise en scène se cale sur les répliques (at("l14")), jamais sur des secondes en dur.
  6. Un atelier par problème : composition Lab pour le visage, RigLab pour le corps, rangée d'essais pour un doute.
  7. Rendre, regarder, corriger : image fixe → planche par scène → vidéo finale relue à 1 image/s.
  8. Un audit sévère par un regard neuf avant toute refonte.
  9. Validation humaine tôt : le personnage et la direction de style avant le rendu long.
  10. 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 .mjs et 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.

Skills associés