theus-cli 0.2.83 → 0.2.85

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

@@ -1,220 +0,0 @@
----
-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

@@ -1,89 +0,0 @@
-# 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.