Kit de calidad Three.js — recursos, método, checklist
Este skill responde a una pregunta: ¿qué ha hecho pasar nuestros videos Three.js de «primitivas apiladas» a una película con personaje riggeado, ciudad real y puesta en escena limpia? Tres cosas: recursos añadidos sobre la marcha, un método de trabajo y una revisión sistemática. El skill hermano threejs-code-video contiene el detalle técnico (pipeline, personaje, cámara, bucles, trampas); este es la visión general y el kit de inicio.
Contenido
| Archivo | Para qué sirve |
|---|---|
| references/ressources.md | Inventario completo: repositorios, skills, sitios, herramientas, servicios — qué aporta cada uno, cómo instalarlo, licencia |
| references/methode.md | La forma de hacer, paso a paso, y los 6 palancas que realmente subieron la calidad |
| references/checklist.md | Checklist a marcar: instalación, antes de codificar, durante, antes de enviar |
scripts/install-kit.js | Instala los skills públicos del kit en un proyecto (clona + copia, sin dependencias) |
scripts/planche.js | Video → tablero de contactos (1 imagen/s) para revisar un render completo |
scripts/polyfork-fetch.js | Busca y descarga modelos Polyfork (módulos .mjs parametrizables) |
scripts/face-landmarks.py, scripts/face-measure.py | Medir un rostro en foto (MediaPipe) en lugar de estimarlo a ojo |
Los recursos en un minuto
| Necesidad | Recurso | Estado en nuestro caso |
|---|---|---|
| Three.js actualizado (r186), R3F, shaders, luces… | 13 skills threejs-* — CloudAI-X/threejs-skills | instalados, consultados en cada composición |
| Renderizado de video cuadro por cuadro | 8 skills Remotion — remotion-dev/skills | instalados |
| Método + plantilla de video en código | skill threejs-code-video + repositorio Alex-sia99/threejs-code-video | escritos por nosotros, públicos |
| Objetos, decorados, personajes low-poly | Polyfork (polyfork.dev, índice lucas-martinic/polyfork-catalog) | usado en la película v3 — módulos .mjs nunca redistribuidos |
| Cuerpo animado | esqueleto y clips Mixamo | cuerpo riggeado de la película v3 |
| Semejanza a partir de foto | img2threejs/img2threejs + MediaPipe Face Landmarker | método «medir, no estimar» adoptado |
| Imágenes de referencia antes de modelar | Kie.ai nano-banana-2-lite | usado para proporciones y decorados |
| Voz, efectos, música | ElevenLabs, Suno, FFmpeg | pipeline completo |
| Dibujo 2D en código (otro estilo) | alexgreensh/anidoodle, html-anime | instalados, fuera de Three.js |
Detalle, enlaces y reservas: references/ressources.md.
El método en diez líneas
- Una referencia ante todo: video de estilo analizado en tablero, imágenes de referencia, foto medida.
- Los skills antes del código: cargar el skill
threejs-*oremotion-*correspondiente, nunca escribir la API de memoria. - Estudiar buen código, luego reescribir: leer un módulo bien hecho, anotar el método, codificar el propio.
- Todo es una función pura del número de imagen: semilla fija, caminar por distancia, ningún estado acumulado.
- Guión → voz → línea de tiempo: la puesta en escena se ajusta a las réplicas (
at("l14")), nunca a segundos fijos. - Un taller por problema: composición
Labpara el rostro,RigLabpara el cuerpo, serie de pruebas para una duda. - Renderizar, ver, corregir: imagen fija → tablero por escena → video final revisado a 1 imagen/s.
- Una auditoría severa por una mirada nueva antes de cualquier reforma.
- Validación humana temprana: el personaje y la dirección de estilo antes del render largo.
- Capitalizar: cada trampa encontrada va a
pitfalls.md, cada método a un skill.
Detalle: references/methode.md.
Reglas no negociables
- Nunca enviar un render no revisado. Una imagen fija no basta para una película: revisar el video final en tablero.
- El estilo prima sobre la precisión. Un rostro fotorrealista en un mundo estilizado fue rechazado dos veces; la semejanza se logra con forma y pocos rasgos nítidos.
- Respetar las licencias. Polyfork: uso en video libre, módulos
.mjsy clips cocinados nunca en un repositorio público ni en un pack. - Un rasgo = un volumen, un lugar = un objeto reconocible, una réplica = un visual que la muestra.
Transmitir el kit a un estudiante
El kit está publicado en el repositorio https://github.com/Alex-sia99/threejs-quality-kit: basta con enviar ese enlace. El README se dirige al estudiante (prerrequisitos, instalación en 3 pasos, frases para dar a su agente); install.js descarga por sí mismo los skills públicos y el proyecto de inicio, por lo que el repositorio se mantiene ligero y actualizado. Nunca añadir allí módulos Polyfork .mjs, clips anim-*.json, clave de API, foto ni voz personal.