theus-cli-linux-x64 0.2.84

package/vendor/theus-arsenal/skills/direccion-estetica/SKILL.md

@@ -0,0 +1,220 @@
+---
+name: direccion-estetica
+description: "Capa de dirección creativa (taste) para videos musicales y edits de formato corto en la familia visual angelcore / cloud-trance / hyperpop. Destila un vocabulario de géneros visuales con nombre, un sistema de mood + color + luz y una gramática de edición sincronizada al beat, y encadena las skills de video del arsenal (edicion-video, creacion-video-remotion, motor-de-contenido) en un solo pipeline de producción. Úsala cuando el trabajo no sea solo que el video funcione sino que se sienta intencional: un video musical, un fancam/edit, un reel guiado por moodboard, o al elegir una dirección visual coherente para b-roll generado por IA."
+---
+
+# Dirección estética
+
+La mayoría de los consejos de video con IA se detienen en *cómo renderizar cuadros*. Esta skill es la capa de arriba: **qué deben mostrar los cuadros, en qué orden, cortados a qué ritmo, para que el resultado se lea como una sola cosa intencional y no como una pila de generaciones.**
+
+Codifica un gusto específico — la familia **angelcore / cloud-trance / hyperpop** (trance etéreo de la era "Silver Surfer" de Bladee cruzado con angelcore pesado) — destilado de un corpus de Reels guardados y de un recorrido por una biblioteca de ~70 géneros visuales con nombre. Es deliberadamente opinada. El gusto es un punto de vista, no un menú.
+
+> El archivo complementario `references/taxonomia-generos.md` contiene el catálogo completo de géneros con nombre. Este archivo es la capa accionable: mood, gramática, pipeline y un plan de tomas mapeado al beat.
+
+## Cuándo activarla
+
+- Al construir un **video musical**, lyric video, fancam o visualizador.
+- Al hacer un **edit / reel** de formato corto donde el *feeling* importa más que la información.
+- Al dirigir la **generación de b-roll con IA** (fal.ai, Kling u otros modelos generativos) y los prompts necesitan una dirección coherente en lugar de ocurrencias sueltas.
+- Al armar un **moodboard** o elegir un género visual antes de renderizar nada.
+- Cuando el usuario dice "taste", "que se sienta como X", "dale una dirección", "angelcore", "cloud trance", "edit hyperpop", "Bladee", "dreamcore", o nombra una referencia guardada.
+- Cuando el edit actual funciona pero se lee plano, genérico, como relleno de IA o estilísticamente incoherente.
+
+Esta skill se apoya **encima de** `edicion-video` (la mecánica) y `creacion-video-remotion` (el renderizador). Usa esas para el *cómo*. Usa esta para el *qué y por qué*.
+
+## Tesis central
+
+1. **El gusto es la última capa, y debe decidirse primero.** `edicion-video` dice con razón que el gusto es el pase humano final. La trampa: si solo decides el gusto al final, cada generación y cada corte anterior fue una adivinanza. Elige la dirección *antes* del primer prompt y deja que restrinja todo lo demás.
+2. **La coherencia le gana a la novedad.** Un look ejecutado en 30 tomas vale más que 30 looks. Un género con nombre (abajo) es una restricción que compra coherencia gratis.
+3. **Corta a la canción, no al metraje.** En un video musical la línea de tiempo es la forma de onda. Cada corte duro cae en un beat o un transitorio. La matemática de cuadros está en la sección de pipeline.
+4. **Genera con selectividad, edita sin piedad.** La IA fabrica b-roll que no existe; no fabrica gusto. Igual desechas el 80 %.
+
+## El vocabulario estético (destilado)
+
+El corpus de referencia recorre una biblioteca grande de géneros visuales *con nombre*. La lista completa vive en `references/taxonomia-generos.md`. El movimiento útil no es memorizar 70 nombres — es ver que **un nombre de género es un preset completo de prompt y de etalonaje.** Al elegir uno, heredas su paleta, textura, iluminación y temática como una unidad.
+
+Los géneros se agrupan en familias. Elige una familia **primaria** y como máximo **un acento**:
+
+| Familia | Géneros que incluye | Se lee como |
+|---------|--------------------|-------------|
+| **Etéreo / divino** | spiritualism, glacial folk, beacons, zen core, fairy tale | ingrávido, sagrado, resplandeciente, suave |
+| **Hyperpop / Y2K-cyber** | cyberdelia, acid house, acid nora, neo aggressano, new liquid | brillante, cromo, neón, kawaii-cyber |
+| **Oscuro / ocultista** | dark academia, smoke nostalgia, communist core, abstract tech | alto contraste, ominoso, grano |
+| **Retro / impreso** | retro surfers, art deco, adventure pulp, classic advertising, magazine collage, bumper stickers | plano, gráfico, semitono, nostálgico |
+| **Orgánico / textural** | microbiology core, weaving patterns, fruitage retro, cozy blanket, pacific punk wave | táctil, macro, tejido, húmedo |
+| **Sistémico / datos** | numbers, mazes, code web, heatmap, pixel, 8-bit | cuadriculado, generativo, esquemático |
+
+**Para el proyecto actual**, la primaria es **Etéreo / divino** con un acento **Hyperpop / Y2K-cyber** — es decir, luz sagrada y bloom cristalino, puntuados por cromo y neón. Ese emparejamiento *es* el brief angelcore × cloud-trance.
+
+## El sistema de mood — angelcore × cloud-trance
+
+Destilado directamente de los reels de referencia más fuertes. Este es el etalonaje concreto.
+
+### Paleta
+- **Base:** vacío casi negro (#05060a) y blanco hueso (#f4f1ea). La mayoría de los cuadros son uno u otro.
+- **Acento divino:** dorado fundido / naranja brasa (#ffb24d → #ff7a18) — la *única luz cálida* en la oscuridad.
+- **Acento cristalino:** bokeh iridiscente violeta→cian→magenta (#8a6bff, #4fc3ff, #ff6ad5) — el bloom hyperpop, usado en cuadros claros.
+- **Acento de peligro (con moderación):** un solo rojo brillante (#ff2a2a) sobre monocromo — para uno o dos cortes de impacto, nada más.
+- **Sujeto hyperpop:** cabello rosa chicle / cromo / blanco brillante contra cielo azul.
+
+Regla: **un acento por toma.** El dorado vive en los cuadros oscuros; la iridiscencia vive en los claros; nunca ambos en una misma toma.
+
+### Luz y textura
+- Oscuridad atravesada por una sola fuente cálida (bloom de brasa, haz divino). Alto contraste, negros profundos.
+- Bokeh cristalino / de purpurina, destellos de lente, bloom, light leaks — *celestiales*, no sucios.
+- Grano de película + aberración cromática sutil en los cuadros oscuros; brillo limpio en los claros.
+- Detalle macro sobre espacio negativo: un objeto héroe centrado en negro (llave, ojo, engranaje, pétalo, agua).
+- Sujetos: figuras aladas, nubes, halos, ángeles, estructuras cristalinas, retratos candy-cyber.
+
+### Movimiento
+- Cámara lenta, flotante, ingrávida (deriva, push lento, órbita lenta) — trance de *nube*.
+- Ráfagas de velocidad solo en el drop. El resto respira.
+- Partículas ascendentes (brasas, polvo, purpurina) — movimiento hacia arriba = ascensión.
+
+## La gramática de edición (destilada)
+
+De los edits de referencia, las técnicas que se repiten y definen el estilo:
+
+1. **Cortes duros anclados al beat.** Nada de disolvencias en el verso/drop. Corta en el kick. El ojo debe sentir el BPM.
+2. **Insertos macro héroe-sobre-negro.** Un solo objeto nítido centrado en espacio negativo negro, sostenido 1–2 beats, y corte. El montaje rítmico de estos = la firma del cloud-trance.
+3. **Revelado por bloom / explosión.** Un bloom blanco o de brasa que quema el cuadro en un transitorio y se resuelve en la toma siguiente. La transición de "destello divino".
+4. **Golpe de color sobre monocromo.** Corre un pasaje en blanco y negro, y un solo elemento de color (ojo rojo, llama dorada, cabello rosa) irrumpe en el tiempo fuerte.
+5. **Speed-ramp hacia el drop.** Acelera el metraje de lento a rápido en el último compás antes del drop, corte duro a tempo en el uno.
+6. **Resaltado de palabra clave en subtítulos (solo para secciones habladas / de letra).** Mayúsculas, una o dos palabras resaltadas en el color de acento, sincronizadas a la voz. Para lyric video, no para el visualizador puro.
+7. **PiP de reacción (solo para explicativos / comentario de edit).** Busto parlante en picture-in-picture sobre b-roll. Fuera del alcance del video musical en sí; se documenta porque el corpus lo usa mucho.
+
+**Prohibiciones:** transiciones de fundido cruzado en secciones a tempo; más de un color de acento por toma; una toma sostenida más allá de su frase musical; interfaz de pantalla legible en el cuadro (recórtala); relaciones de aspecto mezcladas en una misma línea de tiempo.
+
+## El pipeline — mezcla de las skills de video del arsenal
+
+Esta skill es el director de orquesta. Cada skill del arsenal es un instrumento. No te saltes capas.
+
+```
+0. DIRECCIÓN (esta skill)         decide género + mood + gramática ANTES de renderizar nada
+1. ESTRUCTURA (edicion-video)     mapea la canción: timestamps de intro/verso/drop/puente/outro
+2. GENERAR (fal.ai vía edicion-video) crea b-roll con los presets de prompt por género; desecha el 80 %
+3. CORTAR (edicion-video/FFmpeg)  corta al beat + reencuadra a 9:16; ensambla los selects en la grilla
+4. COMPONER (creacion-video-remotion) overlays, blooms, texto de letra, secuenciado al beat
+5. MOVIMIENTO (fundamentos-animacion, patrones-animacion, motion-avanzado) curvas de easing, light leaks/partículas, tiempos de transición
+6. AUDIO (fal.ai vía edicion-video)  risers/impactos de transición para vender los cortes (la pista en sí vive en Ableton)
+7. PULIDO                         etalona a la paleta de arriba, pase final de ritmo, exporta
+8. DISTRIBUIR (motor-de-contenido) versiones nativas por plataforma + caption/portada
+```
+
+| Paso | Skill del arsenal a cargar | Qué hace aquí |
+|------|---------------------------|----------------|
+| Estructura y corte | `edicion-video` | corte/concat/reencuadre con FFmpeg, EDL, detección de escenas/silencios |
+| Generar b-roll | `edicion-video` (capa fal.ai) | modelos de imagen/video según el preset de género |
+| Componer y superponer | `creacion-video-remotion` | `<Sequence>`s sincronizadas al beat, texto, blooms, máscaras |
+| Tiempos de movimiento | `fundamentos-animacion`, `patrones-animacion`, `motion-avanzado` | easing, springs, movimiento de luz/partículas |
+| Video del lado servidor | `videodb` | reencuadre inteligente e indexado si el metraje es grande |
+| Distribución | `motor-de-contenido` | cortes por plataforma, portadas, captions |
+| Voz / VO de letra | `edicion-video` (sección ElevenLabs) | solo si se necesita una capa hablada |
+
+## Matemática del beat (ancla los cortes a la canción)
+
+La pista actual está a **138 BPM, Si menor**. Constantes:
+
+- `segundos_por_beat = 60 / 138 = 0.43478s`
+- `cuadros_por_beat  = fps × 0.43478`  →  **24fps: 10.43**, **30fps: 13.04**, **60fps: 26.09**
+- `1 compás (4 beats) = 1.7391s`  →  30fps: **52.17 cuadros**
+- `frase de 8 compases = 13.913s`  →  la longitud del loop de la pista
+
+En Remotion, ajusta cada `from={}` a un beat:
+```ts
+const FPS = 30;
+const BPM = 138;
+const beat = (n: number) => Math.round(n * (60 / BPM) * FPS); // beat(n) → cuadro
+// cortar en los beats 0,4,8,... :  <Sequence from={beat(0)} durationInFrames={beat(4)}> ...
+```
+
+## Plan de tomas mapeado al beat (este video musical)
+
+El arreglo de la canción (según las notas del propio proyecto) es
+**Intro → Verso → Drop → Puente → Drop → Outro (~2:05)**. Mapea la dirección a cada sección:
+
+| Sección | Género/mood dominante | Gramática | Ideas de toma |
+|---------|----------------------|-----------|---------------|
+| **Intro** | Etéreo/divino, casi negro | push lento, sin cortes | bloom de brasa en el vacío; un solo haz dorado; polvo ascendiendo |
+| **Verso** | Oscuro + macro héroe-sobre-negro | cortes duros cada 2 beats | llave, ojo, engranaje, gota de agua, pétalo — montaje macro rítmico |
+| **Drop** | Bloom hyperpop + cristalino | speed-ramp de entrada, corte en el uno, rápido | figura rosa chicle, cromo, bokeh iridiscente, ascensión alada |
+| **Puente** | Spiritualism, ingrávido | una toma larga sostenida, golpe de color | nubes + halo; un solo acento rojo irrumpe una vez |
+| **Drop 2** | como el Drop, intensificado | añade destellos divinos en los transitorios | alas que se abren, estallido de purpurina, light leaks al máximo |
+| **Outro** | Glacial folk, calma fría | fundido lento a negro | estructura cristalina disolviéndose; la brasa se apaga |
+
+## Presets de prompt para fal.ai (por mood)
+
+Úsalos con la capa fal.ai de `edicion-video`. Cada preset es el género renderizado a la paleta del proyecto. Añade a todos `9:16, vertical, cinematic, film grain, volumetric light, no text, no watermark`.
+
+- **Vacío divino:** "a single molten-gold ember bloom rising in an infinite near-black void, deep shadow, one warm light source, weightless dust particles, holy, high contrast"
+- **Macro héroe:** "extreme macro of an antique brass key / a human eye / interlocking gears, centered on pure black negative space, razor-sharp detail, single rim light"
+- **Bloom cristalino:** "iridescent violet-cyan-magenta crystalline bokeh, glittering light refraction, dreamy lens flares, heavenly glow, soft focus, hyperpop angelcore"
+- **Retrato candy-cyber:** "candy-pink-haired figure, glossy chrome accents, bright blue sky, Y2K hyperpop, clean gloss, saturated, kawaii-cyber"
+- **Ascensión alada:** "a winged figure ascending into clouds, halo of light, bone-white and gold, volumetric god-rays, ethereal, religious iconography, soft"
+- **Outro frío:** "pale crystalline ice structure slowly dissolving, glacial folk, cold blue and bone white, minimal, calm, fading to black"
+
+Genera de 6 a 10 por preset, quédate con 2–3. Para movimiento, anima stills con un modelo imagen-a-video o genera clips cortos directamente; mantén los movimientos de cámara lentos según las reglas de Movimiento.
+
+## Recetas de FFmpeg (corte + reencuadre)
+
+```bash
+# Reencuadrar cualquier clip horizontal/crudo a 9:16 (recorte centrado)
+ffmpeg -i in.mp4 -vf "crop=ih*9/16:ih,scale=1080:1920" v.mp4
+
+# Cortar un clip a exactamente N beats a 138 BPM (p. ej. 2 beats = 0.8696s)
+ffmpeg -i in.mp4 -t 0.8696 -c copy beat2.mp4
+
+# Concatenar los selects al beat en el montaje del verso
+for f in selects/*.mp4; do echo "file '$f'"; done > concat.txt
+ffmpeg -f concat -safe 0 -i concat.txt -c copy verso.mp4
+
+# Quitar interfaz / barra de estado de una referencia grabada en pantalla (recorte arriba+abajo)
+ffmpeg -i reel.mp4 -vf "crop=iw:ih-300:0:150" limpio.mp4
+```
+
+## Esqueleto de composición en Remotion (sincronizado al beat)
+
+```tsx
+import { AbsoluteFill, Sequence, Video, Img, useCurrentFrame, interpolate } from "remotion";
+
+const FPS = 30, BPM = 138;
+const beat = (n: number) => Math.round(n * (60 / BPM) * FPS);
+
+const Bloom: React.FC = () => {
+  const f = useCurrentFrame();
+  const o = interpolate(f, [0, 3, 12], [0, 1, 0], { extrapolateRight: "clamp" }); // destello divino en un transitorio
+  return <AbsoluteFill style={{ background: "radial-gradient(#fff,#ffb24d)", opacity: o, mixBlendMode: "screen" }} />;
+};
+
+export const AngelcoreMV: React.FC = () => (
+  <AbsoluteFill style={{ background: "#05060a" }}>
+    {/* Verso: macro héroe-sobre-negro, corte duro cada 2 beats */}
+    <Sequence from={beat(0)} durationInFrames={beat(2)}><Video src="/selects/llave.mp4" /></Sequence>
+    <Sequence from={beat(2)} durationInFrames={beat(2)}><Video src="/selects/ojo.mp4" /></Sequence>
+    <Sequence from={beat(4)} durationInFrames={beat(2)}><Video src="/selects/engranaje.mp4" /></Sequence>
+    {/* Drop: bloom cristalino + destello en el uno */}
+    <Sequence from={beat(8)} durationInFrames={beat(16)}><Video src="/selects/cristalino.mp4" /></Sequence>
+    <Sequence from={beat(8)} durationInFrames={beat(1)}><Bloom /></Sequence>
+  </AbsoluteFill>
+);
+```
+Renderiza: `npx remotion render src/index.ts AngelcoreMV out.mp4`. Consulta `creacion-video-remotion` para la configuración del proyecto, la vinculación de la pista de audio y las flags de render.
+
+## Principios clave
+
+1. **Decide el género antes de la primera generación.** Elige una familia primaria + un acento.
+2. **Un color de acento por toma.** Dorado en lo oscuro, iridiscencia en lo claro, rojo una sola vez.
+3. **Cada corte duro cae en un beat.** Usa la matemática del beat; sin transiciones en las secciones a tempo.
+4. **El macro héroe-sobre-negro es el movimiento firma.** Domínalo; sostiene los versos.
+5. **Genera 10, quédate con 2.** La coherencia viene del rechazo, no de promptear más fuerte.
+6. **Recorta la interfaz.** Nada de barras de estado, subtítulos ajenos ni UI en el cuadro final.
+7. **La dirección se decide primero y se juzga al final.** Fija el rumbo y defiéndelo en cada corte.
+
+## Skills relacionadas
+
+- `edicion-video` — el pipeline mecánico (FFmpeg, reencuadre, EDL, pulido, capa fal.ai/ElevenLabs) sobre el que esta skill se apoya
+- `creacion-video-remotion` — composición programable sincronizada al beat y renderizado
+- `fundamentos-animacion`, `patrones-animacion`, `motion-avanzado` — easing y tiempos de movimiento
+- `videodb` — reencuadre inteligente del lado servidor e indexado para metraje grande
+- `motor-de-contenido` — distribución nativa por plataforma, portadas, captions
+- `videos-manim` — explicativos animados si el proyecto necesita segmentos técnicos/diagramáticos

package/vendor/theus-arsenal/skills/direccion-estetica/references/taxonomia-generos.md

@@ -0,0 +1,89 @@
+# Taxonomía de géneros visuales
+
+El catálogo de géneros con nombre destilado del corpus de referencia (un recorrido por una
+biblioteca grande de estilos visuales generativos, más un conjunto de reels angelcore/hyperpop
+guardados). Cada nombre es en la práctica un **preset completo de prompt y de etalonaje**:
+al elegir uno, heredas su paleta, textura, iluminación y temática como una unidad.
+
+Usa esto como selector. Elige **un género primario** y **como máximo un acento**. El
+`SKILL.md` principal agrupa estos géneros en familias y los mapea al proyecto de video
+musical actual.
+
+## Familias y miembros
+
+### Etéreo / divino — *ingrávido, sagrado, resplandeciente, suave*
+- **spiritualism** — iconografía religiosa, halos, god-rays, devocional
+- **glacial folk** — azul frío + blanco hueso, cristalino, minimal, calmo
+- **beacons** — una sola fuente de luz en la oscuridad, señal, esperanza
+- **zen core** — espacio vacío, quietud, equilibrio, apagado
+- **fairy tale** — libro de cuentos, ilustrado, encanto suave
+- **cozy blanket** — cálido, táctil, confort en foco suave
+
+### Hyperpop / Y2K-cyber — *brillante, cromo, neón, kawaii-cyber*
+- **cyberdelia** — cyber psicodélico, saturado, digital que se derrite
+- **acid house** — gráfica rave, smileys, color ácido de alta saturación
+- **acid nora** — pictórico en tonos ácidos, deformado
+- **neo aggressano** — hyperpop maximalista agresivo, colores que chocan
+- **new liquid** — cromo húmedo, metal líquido, reflejo brillante
+- **8-bit / pixel** — píxeles de juego retro, dithering, digital lo-fi
+
+### Oscuro / ocultista — *alto contraste, ominoso, grano*
+- **dark academia** — académico sombrío, sepia, luz de vela, gótico
+- **smoke nostalgia** — brumoso, humeante, memoria desvanecida
+- **communist core** — estrella roja, cartel de propaganda, rojo/negro contundente
+- **abstract tech** — esquemático, frío, abstracción técnica
+- **microzoathic** — formas microscópicas orgánico-oscuras extrañas
+
+### Retro / impreso — *plano, gráfico, semitono, nostálgico*
+- **retro surfers** — surf de los 60–70, desteñido por el sol, playero
+- **art deco** — dorado geométrico, elegancia años 20, simetría
+- **adventure pulp** — portadas de cómic pulp, dramático, vintage
+- **classic advertising** — ilustración publicitaria de mediados de siglo
+- **magazine collage** — papel recortado, collage editorial, en capas
+- **bumper stickers** — sticker-bomb, kitsch, calcomanías superpuestas
+- **retro print / riso** — impresión de paleta limitada, semitono, registro desfasado
+- **neo lisboa** — azulejado, inspiración en azulejos, impresión mediterránea
+- **factory pomo** — gráfica industrial posmoderna
+- **2026 austurbano** — editorial urbano de futuro cercano
+
+### Orgánico / textural — *táctil, macro, tejido, húmedo*
+- **microbiology core** — células, micro-orgánico, texturas de placa de Petri
+- **weaving patterns** — fibra tejida, textil, entrelazado
+- **fruitage retro** — frutas/productos, saturado, bodegón brillante
+- **pacific punk wave** — húmedo, oceánico, gráfica lavada
+- **shape design** — formas planas contundentes, geometría tipo Bauhaus
+- **colour fusion** — degradados fundidos, campos de color
+
+### Sistémico / datos — *cuadriculado, generativo, esquemático*
+- **numbers** — tipografía numérica, libros contables, conteo
+- **mazes** — laberinto, recorrido, rompecabezas de grilla
+- **code web** — grafos de nodos, red, conexiones
+- **heatmap** — mapeo térmico de color, gradientes de datos
+- **the builds** — construido/plano técnico, sistemas arquitectónicos
+- **multilayer** — capas transparentes apiladas, profundidad
+- **scrapbooking** — recuerdos ensamblados, efímera en capas
+
+### Cultural / kitsch — *ruidoso, específico, referencial*
+- **catholic kitsch** — kitsch devocional, santos dorados
+- **mexendero / megadero / cubanista** — gráfica vernácula latinoamericana
+- **asian chic / asian store** — vernáculo comercial/pop del Asia oriental
+- **battle of culture** — motivos culturales en choque
+- **premium brands** — empaque de lujo, comercial refinado
+- **pro collectibles** — encuadre de carta coleccionable / trading card
+- **diaper design / suburbia / ivy league / sharp preppy** — Americana suburbana/preppy
+- **carnival difference** — festival, celebración maximalista
+- **men x soft club / faces** — centrado en retrato, soft club
+- **gomu / proteum aero / ice core / visual hex / vidcoms / anti-ai / photo-first** — presets varios observados
+
+> La ortografía o la pertenencia exacta de algunos presets está transcrita de cuadros de
+> pantalla en baja resolución y puede variar levemente respecto de las etiquetas de la app
+> original. Las **familias** son la capa durable y reutilizable; trata los nombres
+> individuales como etiquetas de inspiración, no como identificadores canónicos.
+
+## Cómo usar un género como preset
+
+1. Elige el género que cumpla el trabajo emocional de la sección (ver el plan de tomas en `SKILL.md`).
+2. Tradúcelo a un prompt de fal.ai combinando: *su paleta + su textura + su temática*, y
+   añade el sufijo global del proyecto (`9:16, cinematic, film grain, volumetric light, no text`).
+3. Mantén un solo color de acento; genera de 6 a 10; quédate con 2–3.
+4. Nunca mezcles más que primario + un acento en una misma sección, o el edit pierde coherencia.