theus-cli-darwin-x64 0.2.84

package/vendor/theus-arsenal/skills/inspeccion-animaciones-blender/SKILL.md

@@ -0,0 +1,164 @@
+---
+name: inspeccion-animaciones-blender
+description: Inspecciona personajes, rigs, poses, retargeting de animación, contacto con el suelo,
+  dirección de avance y alineación modelo-movimiento en Blender cuando las capturas de pantalla
+  no bastan. Extrae estado estructurado con Python de Blender antes de juzgar visualmente.
+---
+
+# Inspección de estado de movimiento en Blender
+
+## Cuándo usarla
+
+- Un personaje de Blender se ve torcido, espejado, aplastado, desplazado o con deslizamiento de pies en una animación.
+- Un usuario pregunta si un avatar importado, una armadura o un movimiento retargeteado coincide con la pose esperada.
+- Necesitas comparar evidencia renderizada con hechos estructurados: huesos, cajas delimitadoras, contactos y vectores de orientación.
+- Un flujo de trabajo depende de decidir si un modelo es un personaje, un prop, una malla proxy, un rig de control o una importación rota.
+
+## Principio central
+
+No juzgues activos 3D animados solo por capturas de pantalla. Las capturas son evidencia de revisión, pero ocultan convenciones de ejes, nombres de huesos, escala de objetos, transformaciones locales, mallas emparentadas, slots de materiales y el estado de contacto fotograma a fotograma.
+
+Primero extrae el estado estructurado de Blender; después usa capturas del viewport o renders para confirmar lo que los hechos implican.
+
+## Cómo funciona
+
+1. Establece la escena limpia y la línea base del activo antes de juzgar el movimiento.
+2. Extrae hechos estructurados de Blender con un exportador o con Python de Blender ejecutado dentro del propio intérprete de Blender.
+3. Muestrea los fotogramas con mayor probabilidad de exponer errores de contacto, orientación, escala y retargeting.
+4. Compara los hechos medidos con la pose esperada, la dirección, el plano del suelo y el objetivo de render del usuario.
+5. Devuelve un informe conciso que separe hechos confirmados, causas probables y correcciones necesarias.
+
+## Flujo de inspección
+
+1. Inventaría la escena.
+   - Lista mallas, armaduras, empties, cámaras, luces, modificadores, relaciones de parentesco y objetos ocultos.
+   - Separa las mallas del personaje de la geometría auxiliar/proxy antes de juzgar el avatar.
+   - Registra las cajas delimitadoras en espacio de objeto y en espacio de mundo.
+
+2. Identifica el esqueleto.
+   - Captura nombres de armaduras, pose bones, cabezas/colas de huesos, roll, cadenas de parentesco, constraints y ejes de la pose de reposo.
+   - Mapea los huesos semánticos: caderas, columna, cuello, cabeza, hombros, codos, manos, muslos, rodillas, tobillos y pies.
+   - Marca pares izquierda/derecha ausentes y esquemas de nombres inusuales.
+
+3. Determina los ejes adelante, arriba y lateral.
+   - Usa pelvis, columna, hombros, caderas, cabeza y pies en conjunto; no dependas de una sola normal de malla.
+   - Compara los ejes locales de la armadura con los ejes del mundo y las convenciones del archivo importado, como Y-arriba de glTF frente a Z-arriba de Blender.
+   - Marca importaciones probablemente espejadas o invertidas cuando la dirección de cara/cabeza/pies contradice el movimiento de la raíz.
+
+4. Muestrea fotogramas de la animación.
+   - Inspecciona fotogramas iniciales, intermedios, de contacto, aéreos y extremos.
+   - Registra posición de la raíz, rumbo de la raíz, altura de la pelvis, inclinación del torso, direcciones de extremidades, holgura de los pies y límites de la malla.
+   - En movimientos largos o rápidos, muestrea con más densidad alrededor de giros, aterrizajes, colisiones y contactos con el suelo.
+
+5. Verifica la integridad del modelo antes de culpar al retargeting.
+   - Confirma la forma limpia de línea base antes de aplicar la animación.
+   - Preserva la malla original, materiales, armadura y skinning salvo que el usuario pida explícitamente una reparación.
+   - Trata blobs esféricos inexplicables, mallas proxy gigantes o cuerpos aplastados como problemas de importación/selección hasta que se demuestre lo contrario.
+
+6. Diagnostica problemas de contacto y movimiento.
+   - Penetración del suelo: compara los vértices más bajos del pie o zapato con la altura del suelo por fotograma.
+   - Deslizamiento de pies: compara las posiciones de los pies en espacio de mundo durante los fotogramas apoyados.
+   - Cruce de piernas: compara el orden lateral de muslos, rodillas, tobillos y pies izquierdo/derecho.
+   - Daño por torsión: compara la dirección de balanceo del hueso por separado del roll/torsión alrededor del eje de la extremidad.
+   - Deriva de escala: compara los límites de la malla animada con los límites de la línea base limpia.
+
+7. Informa hechos antes que opiniones.
+   - Incluye números de fotograma, nombres de objetos, nombres de huesos, coordenadas de mundo y umbrales.
+   - Separa fallos confirmados de sospechas visuales.
+   - Adjunta capturas solo cuando el estado estructurado ya explica qué mirar.
+
+## Forma recomendada del informe
+
+```markdown
+## Inspección de movimiento en Blender
+
+### Inventario de escena
+- Candidatos a personaje:
+- Armaduras:
+- Objetos auxiliares/proxy:
+- Cámaras/luces:
+
+### Orientación
+- Arriba del mundo:
+- Adelante del personaje:
+- Rumbo de la raíz:
+- Riesgo de espejado/inversión:
+
+### Integridad de la línea base
+- Límites de la malla limpia:
+- Límites de la malla animada:
+- Materiales/skinning preservados:
+- Mallas sospechosas no pertenecientes al personaje:
+
+### Hallazgos por fotograma
+| Fotograma | Hallazgo | Evidencia |
+| --- | --- | --- |
+| 1 | Pose base limpia | caderas/columna/pies alineados |
+| 96 | El pie penetra el suelo | left_foot min_z = -0.04 |
+
+### Veredicto
+- Pasa/falla:
+- Corrección necesaria:
+- Listo para render:
+```
+
+## Ejemplos
+
+### Ciclo de caminata con deslizamiento de pies
+
+Escenario: un personaje retargeteado parece patinar durante un ciclo de caminata, pero el ángulo frontal de la cámara hace difícil juzgar el contacto de los pies.
+
+Aplica el flujo:
+- Inventaría la escena: malla del personaje `HeroBody`, armadura `HeroRig`, plano de suelo `Floor`, sin mallas proxy ocultas.
+- Identifica el esqueleto: los pies semánticos son `foot.L` y `foot.R`; las caderas son `pelvis`; el hueso raíz es `root`.
+- Muestrea fotogramas: inspecciona los fotogramas 1, 18, 24, 30, 42 y 48 alrededor de los momentos de pie apoyado.
+- Diagnostica contacto y movimiento: compara las posiciones de los pies en espacio de mundo durante los fotogramas apoyados.
+
+Hechos extraídos:
+
+| Fotograma | Hecho | Evidencia |
+| --- | --- | --- |
+| 18 | El pie izquierdo está apoyado | `foot.L min_z = 0.004`, punta y talón cerca del suelo |
+| 24 | El pie izquierdo se desliza estando apoyado | `foot.L x = 0.21 -> 0.28` en seis fotogramas |
+| 30 | La pelvis sigue avanzando | `pelvis y = 1.14 -> 1.31` |
+
+Veredicto: falla para render. El movimiento necesita limpieza de bloqueo de pies o revisión de constraints de retargeting; la malla del cuerpo no necesita cambios de proporción.
+
+### Personaje importado al revés
+
+Escenario: un personaje se ve correcto en un fotograma estático, pero la animación se mueve en dirección opuesta al desplazamiento esperado.
+
+Aplica el flujo:
+- Determina los ejes adelante, arriba y lateral: compara cabeza, pecho, pies y movimiento de la raíz.
+- Muestrea fotogramas: inspecciona el fotograma 1 y el punto medio de la trayectoria.
+- Informa hechos antes que opiniones: incluye por separado el rumbo de la raíz y la dirección a la que mira el modelo.
+
+Hechos extraídos:
+
+| Fotograma | Hecho | Evidencia |
+| --- | --- | --- |
+| 1 | La cara del personaje apunta hacia `-Y` del mundo | el vector cabeza/pecho de `neck` a `head` resuelve a `-Y` |
+| 72 | El movimiento de la raíz viaja hacia `+Y` del mundo | `root y = 0.0 -> 2.8` |
+| 72 | Los pies siguen mirando en dirección opuesta al desplazamiento | los huesos de la punta apuntan a `-Y` mientras el desplazamiento es `+Y` |
+
+Veredicto: probable importación invertida o desajuste del eje de avance en el retargeting. Corrige el mapeo de ejes de importación/retargeting antes de editar curvas de animación.
+
+## Umbrales prácticos
+
+- Asume las unidades de metro por defecto de Blender salvo que la escala de unidades de la escena diga otra cosa.
+- Trata una penetración del suelo mayor a 1-2 cm como visible, salvo que el suelo sea blando o estilizado a propósito.
+- Trata un cambio de escala repentino mayor al 5 % como probable problema de rig, constraint o herencia de transformaciones.
+- Trata las inversiones del orden lateral de los tobillos durante movimiento aéreo invertido como riesgo de cruce de piernas aunque se recupere después.
+- Trata saltos de rumbo de la raíz mayores a 30 grados por fotograma como sospechosos, salvo que el movimiento fuente incluya un giro brusco.
+
+## Antipatrones
+
+- No modifiques las proporciones del cuerpo para forzar la coincidencia de pose salvo que la tarea sea explícitamente reparar la malla.
+- No hagas bake que destruya la línea base limpia antes de registrarla.
+- No uses un solo ángulo de cámara renderizado como prueba de que una pose es correcta.
+- No borres objetos auxiliares hasta haber registrado por qué no forman parte del personaje.
+- No asumas que un avatar mira hacia +Y, -Y, +X o -X sin verificar cabeza, pies, torso y movimiento de la raíz en conjunto.
+
+## Notas de tooling
+
+Si hay disponible un exportador de estado de Blender, prefiere JSON que incluya mallas, armaduras, pose bones, materiales, contactos, cajas delimitadoras y fotogramas muestreados. Si no existe exportador, ejecuta un script pequeño de Python a través del propio Blender, por ejemplo `blender --background escena.blend --python recolectar_estado_movimiento.py`, porque `bpy` no está disponible en un intérprete de Python normal del sistema.