theus-cli-darwin-x64 0.2.84

package/vendor/theus-arsenal/skills/edicion-video/SKILL.md

@@ -0,0 +1,289 @@
+---
+name: edicion-video
+description: Flujos de edición de video asistida por IA para cortar, estructurar y aumentar metraje real. Cubre el pipeline completo desde la captura en bruto pasando por FFmpeg, Remotion, ElevenLabs y fal.ai hasta el pulido final en Descript o CapCut. Úsala cuando se quiera editar video, cortar metraje, crear vlogs o producir contenido en video.
+---
+
+# Edición de video
+
+Edición asistida por IA para metraje real. No es generación desde prompts. Es editar video existente, rápido.
+
+## Cuándo activarla
+
+- Se quiere editar, cortar o estructurar metraje de video
+- Convertir grabaciones largas en contenido de formato corto
+- Construir vlogs, tutoriales o videos demo a partir de captura en bruto
+- Añadir overlays, subtítulos, música o voz en off a video existente
+- Reencuadrar video para distintas plataformas (YouTube, TikTok, Instagram)
+- El usuario dice "editar video", "corta este metraje", "haz un vlog" o "flujo de video"
+
+## Tesis central
+
+La edición de video con IA es útil cuando dejas de pedirle que cree el video completo y empiezas a usarla para comprimir, estructurar y aumentar metraje real. El valor no es la generación. El valor es la compresión.
+
+## El pipeline
+
+```
+Grabación de pantalla / metraje en bruto
+  → El agente (organización y planificación)
+  → FFmpeg
+  → Remotion
+  → ElevenLabs / fal.ai
+  → Descript o CapCut
+```
+
+Cada capa tiene un trabajo específico. No te saltes capas. No intentes que una sola herramienta lo haga todo.
+
+## Capa 1: captura (grabación de pantalla / metraje en bruto)
+
+Reúne el material de origen:
+- **Grabador de pantalla** (p. ej. Screen Studio): grabaciones pulidas para demos de apps, sesiones de código, flujos en el navegador
+- **Metraje de cámara en bruto**: material de vlog, entrevistas, grabaciones de eventos
+
+Salida: archivos en bruto listos para organizar.
+
+## Capa 2: organización (el agente)
+
+Usa el agente para:
+- **Transcribir y etiquetar**: generar la transcripción, identificar temas y ejes
+- **Planificar la estructura**: decidir qué se queda, qué se corta y qué orden funciona
+- **Identificar secciones muertas**: encontrar pausas, divagaciones, tomas repetidas
+- **Generar la lista de decisiones de edición (EDL)**: timestamps de cortes, segmentos a conservar
+- **Armar el código de FFmpeg y Remotion**: generar los comandos y las composiciones
+
+```
+Prompt de ejemplo:
+"Aquí está la transcripción de una grabación de 4 horas. Identifica los 8 segmentos
+más fuertes para un vlog de 24 minutos. Dame los comandos de corte de FFmpeg para cada segmento."
+```
+
+Esta capa trata de estructura, no del gusto creativo final.
+
+## Capa 3: cortes deterministas (FFmpeg)
+
+FFmpeg se encarga del trabajo aburrido pero crítico: dividir, recortar, concatenar y preprocesar.
+
+### Extraer un segmento por timestamp
+
+```bash
+ffmpeg -i raw.mp4 -ss 00:12:30 -to 00:15:45 -c copy segmento_01.mp4
+```
+
+### Corte por lotes desde la lista de decisiones de edición
+
+```bash
+#!/bin/bash
+# cuts.txt: inicio,fin,etiqueta
+while IFS=, read -r start end label; do
+  ffmpeg -i raw.mp4 -ss "$start" -to "$end" -c copy "segments/${label}.mp4"
+done < cuts.txt
+```
+
+### Concatenar segmentos
+
+```bash
+# Crear la lista de archivos
+for f in segments/*.mp4; do echo "file '$f'"; done > concat.txt
+ffmpeg -f concat -safe 0 -i concat.txt -c copy ensamblado.mp4
+```
+
+### Crear un proxy para editar más rápido
+
+```bash
+ffmpeg -i raw.mp4 -vf "scale=960:-2" -c:v libx264 -preset ultrafast -crf 28 proxy.mp4
+```
+
+### Extraer el audio para transcripción
+
+```bash
+ffmpeg -i raw.mp4 -vn -acodec pcm_s16le -ar 16000 audio.wav
+```
+
+### Normalizar niveles de audio
+
+```bash
+ffmpeg -i segmento.mp4 -af loudnorm=I=-16:TP=-1.5:LRA=11 -c:v copy normalizado.mp4
+```
+
+## Capa 4: composición programable (Remotion)
+
+Remotion convierte los problemas de edición en código componible. Úsalo para lo que los editores tradicionales hacen doloroso:
+
+### Cuándo usar Remotion
+
+- Overlays: texto, imágenes, branding, rótulos (lower thirds)
+- Visualizaciones de datos: gráficos, estadísticas, números animados
+- Motion graphics: transiciones, animaciones explicativas
+- Escenas componibles: plantillas reutilizables entre videos
+- Demos de producto: capturas anotadas, resaltados de UI
+
+### Composición básica de Remotion
+
+```tsx
+import { AbsoluteFill, Sequence, Video, useCurrentFrame } from "remotion";
+
+export const VlogComposition: React.FC = () => {
+  const frame = useCurrentFrame();
+
+  return (
+    <AbsoluteFill>
+      {/* Metraje principal */}
+      <Sequence from={0} durationInFrames={300}>
+        <Video src="/segments/intro.mp4" />
+      </Sequence>
+
+      {/* Título superpuesto */}
+      <Sequence from={30} durationInFrames={90}>
+        <AbsoluteFill style={{
+          justifyContent: "center",
+          alignItems: "center",
+        }}>
+          <h1 style={{
+            fontSize: 72,
+            color: "white",
+            textShadow: "2px 2px 8px rgba(0,0,0,0.8)",
+          }}>
+            El stack de edición con IA
+          </h1>
+        </AbsoluteFill>
+      </Sequence>
+
+      {/* Siguiente segmento */}
+      <Sequence from={300} durationInFrames={450}>
+        <Video src="/segments/demo.mp4" />
+      </Sequence>
+    </AbsoluteFill>
+  );
+};
+```
+
+### Renderizar la salida
+
+```bash
+npx remotion render src/index.ts VlogComposition output.mp4
+```
+
+Consulta la [documentación de Remotion](https://www.remotion.dev/docs) para patrones detallados y referencia de la API. Para producción de video con Remotion de principio a fin, usa la skill `creacion-video-remotion`.
+
+## Capa 5: activos generados (ElevenLabs / fal.ai)
+
+Genera solo lo que necesitas. No generes el video entero.
+
+### Voz en off con ElevenLabs
+
+```python
+import os
+import requests
+
+resp = requests.post(
+    f"https://api.elevenlabs.io/v1/text-to-speech/{voice_id}",
+    headers={
+        "xi-api-key": os.environ["ELEVENLABS_API_KEY"],
+        "Content-Type": "application/json"
+    },
+    json={
+        "text": "Tu texto de narración aquí",
+        "model_id": "eleven_turbo_v2_5",
+        "voice_settings": {"stability": 0.5, "similarity_boost": 0.75}
+    }
+)
+with open("voz_en_off.mp3", "wb") as f:
+    f.write(resp.content)
+```
+
+### Música, SFX y visuales generados con fal.ai
+
+Si tienes acceso configurado a fal.ai, úsalo para:
+- Generación de música de fondo
+- Efectos de sonido y sonidos de transición
+- Tomas de relleno, miniaturas o b-roll que no existe
+
+```
+generate(app_id: "fal-ai/nano-banana-pro", input_data: {
+  "prompt": "miniatura profesional para vlog de tecnología, fondo oscuro, código en pantalla",
+  "image_size": "landscape_16_9"
+})
+```
+
+## Capa 6: pulido final (Descript / CapCut)
+
+La última capa es humana. Usa un editor tradicional para:
+- **Ritmo**: ajustar cortes que se sienten muy rápidos o muy lentos
+- **Subtítulos**: autogenerados y luego limpiados a mano
+- **Corrección de color**: corrección básica y atmósfera
+- **Mezcla final de audio**: balancear voz, música y niveles de SFX
+- **Exportación**: formatos y calidades específicos de cada plataforma
+
+Aquí es donde vive el gusto. La IA despeja el trabajo repetitivo. Tú tomas las decisiones finales.
+
+## Reencuadre para redes sociales
+
+Cada plataforma necesita una relación de aspecto distinta:
+
+| Plataforma | Relación de aspecto | Resolución |
+|------------|--------------------|------------|
+| YouTube | 16:9 | 1920x1080 |
+| TikTok / Reels | 9:16 | 1080x1920 |
+| Feed de Instagram | 1:1 | 1080x1080 |
+| X / Twitter | 16:9 o 1:1 | 1280x720 o 720x720 |
+
+### Reencuadre con FFmpeg
+
+```bash
+# 16:9 a 9:16 (recorte centrado)
+ffmpeg -i input.mp4 -vf "crop=ih*9/16:ih,scale=1080:1920" vertical.mp4
+
+# 16:9 a 1:1 (recorte centrado)
+ffmpeg -i input.mp4 -vf "crop=ih:ih,scale=1080:1080" cuadrado.mp4
+```
+
+Para reencuadre inteligente con seguimiento del sujeto necesitas un servicio o herramienta con detección visual; si no lo tienes disponible, el recorte centrado de FFmpeg es la opción determinista.
+
+## Detección de escenas y corte automático
+
+### Detección de escenas con FFmpeg
+
+```bash
+# Detectar cambios de escena (umbral 0.3 = sensibilidad moderada)
+ffmpeg -i input.mp4 -vf "select='gt(scene,0.3)',showinfo" -vsync vfr -f null - 2>&1 | grep showinfo
+```
+
+### Detección de silencios para corte automático
+
+```bash
+# Encontrar segmentos silenciosos (útil para cortar aire muerto)
+ffmpeg -i input.mp4 -af silencedetect=noise=-30dB:d=2 -f null - 2>&1 | grep silence
+```
+
+### Extracción de momentos destacados
+
+Pide al modelo que analice transcripción + timestamps de escenas:
+```
+"Dada esta transcripción con timestamps y estos puntos de cambio de escena,
+identifica los 5 clips de 30 segundos más atractivos para redes sociales."
+```
+
+## Qué hace mejor cada herramienta
+
+| Herramienta | Fortaleza | Debilidad |
+|-------------|-----------|-----------|
+| El agente | Organización, planificación, generación de código | No es la capa de gusto creativo |
+| FFmpeg | Cortes deterministas, procesamiento por lotes, conversión de formatos | Sin UI de edición visual |
+| Remotion | Overlays programables, escenas componibles, plantillas reutilizables | Curva de aprendizaje para no desarrolladores |
+| Grabador de pantalla | Grabaciones pulidas de inmediato | Solo captura de pantalla |
+| ElevenLabs | Voz, narración, música, SFX | No es el centro del flujo |
+| Descript / CapCut | Ritmo final, subtítulos, pulido | Manual, no automatizable |
+
+## Principios clave
+
+1. **Edita, no generes.** Este flujo es para cortar metraje real, no para crear desde prompts.
+2. **Estructura antes que estilo.** Consigue la historia correcta en la capa 2 antes de tocar nada visual.
+3. **FFmpeg es la columna vertebral.** Aburrido pero crítico. Donde el metraje largo se vuelve manejable.
+4. **Remotion para lo repetible.** Si lo vas a hacer más de una vez, conviértelo en un componente de Remotion.
+5. **Genera selectivamente.** Usa la generación con IA solo para activos que no existen, no para todo.
+6. **El gusto es la última capa.** La IA despeja el trabajo repetitivo. Tú tomas las decisiones creativas finales.
+
+## Skills relacionadas
+
+- `creacion-video-remotion` — producción de video programática con Remotion
+- `motor-de-contenido` — distribución de contenido nativo por plataforma
+- `videos-manim` — videos de animación matemática/técnica con Manim

package/vendor/theus-arsenal/skills/enfoque-producto/SKILL.md

@@ -0,0 +1,91 @@
+---
+name: enfoque-producto
+description: Valida el "porqué" antes de construir, ejecuta diagnósticos de producto y somete a presión la dirección del producto antes de que la petición se convierta en un contrato de implementación.
+---
+
+# Enfoque de producto — Piensa antes de construir
+
+Este carril es dueño del diagnóstico de producto, no de la redacción de especificaciones listas para implementar.
+
+Si el usuario necesita un artefacto duradero de PRD-a-SRS o un contrato de capacidades, deriva a `capacidad-producto`.
+
+## Cuándo usarla
+
+- Antes de empezar cualquier funcionalidad — validar el "porqué"
+- Revisión semanal de producto — ¿estamos construyendo lo correcto?
+- Cuando hay bloqueo eligiendo entre funcionalidades
+- Antes de un lanzamiento — verificación de cordura del recorrido del usuario
+- Al convertir una idea vaga en un brief de producto antes de que empiece la planificación de ingeniería
+
+## Cómo funciona
+
+### Modo 1: diagnóstico de producto
+
+Como una sesión de mentoría de aceleradora, pero automatizada. Hace las preguntas difíciles:
+
+```
+1. ¿Para quién es esto? (una persona concreta, no "desarrolladores")
+2. ¿Cuál es el dolor? (cuantifica: con qué frecuencia, qué tan grave, qué hacen hoy)
+3. ¿Por qué ahora? (¿qué cambió que lo hace posible o necesario?)
+4. ¿Cuál es la versión de 10 estrellas? (si dinero y tiempo fueran ilimitados)
+5. ¿Cuál es el MVP? (lo más pequeño que demuestra la tesis)
+6. ¿Cuál es el anti-objetivo? (¿qué NO vas a construir, explícitamente?)
+7. ¿Cómo sabes que funciona? (una métrica, no sensaciones)
+```
+
+Salida: un `PRODUCT-BRIEF.md` con respuestas, riesgos y una recomendación de continuar/no continuar.
+
+Si el resultado es "sí, constrúyelo", el siguiente carril es `capacidad-producto`, no más teatro de fundadores.
+
+### Modo 2: revisión con lente de fundador
+
+Revisa el proyecto actual con mirada de fundador:
+
+```
+1. Lee README, AGENTS.md, package.json y commits recientes
+2. Infiere: ¿qué intenta ser esto?
+3. Puntúa: señales de encaje producto-mercado (0-10)
+   - Trayectoria de crecimiento de uso
+   - Indicadores de retención (contribuidores recurrentes, usuarios que vuelven)
+   - Señales de ingresos (página de precios, código de facturación, integración con Stripe)
+   - Foso competitivo (¿qué es difícil de copiar?)
+4. Identifica: la única cosa que multiplicaría esto por 10
+5. Señala: lo que estás construyendo y no importa
+```
+
+### Modo 3: auditoría del recorrido del usuario
+
+Mapea la experiencia real del usuario:
+
+```
+1. Clona/instala el producto como usuario nuevo
+2. Documenta cada punto de fricción (pasos confusos, errores, docs faltantes)
+3. Cronometra cada paso
+4. Compara con el onboarding de la competencia
+5. Puntúa: tiempo-hasta-valor (¿cuánto tarda el usuario en su primera victoria?)
+6. Recomienda: los 3 arreglos principales del onboarding
+```
+
+### Modo 4: priorización de funcionalidades
+
+Cuando tienes 10 ideas y debes elegir 2:
+
+```
+1. Lista todas las funcionalidades candidatas
+2. Puntúa cada una: impacto (1-5) × confianza (1-5) ÷ esfuerzo (1-5)
+3. Ordena por puntaje ICE
+4. Aplica restricciones: runway, tamaño de equipo, dependencias
+5. Salida: hoja de ruta priorizada con justificación
+```
+
+## Salida
+
+Todos los modos producen documentos accionables, no ensayos. Cada recomendación incluye un siguiente paso concreto.
+
+## Integración
+
+Combínala con:
+- La skill `qa-navegador` para verificar los hallazgos de la auditoría del recorrido del usuario
+- La skill `sistema-diseno` (modo auditoría) para evaluar el pulido visual
+- `/vigilancia-canary` para el monitoreo posterior al lanzamiento
+- `capacidad-producto` cuando el brief de producto deba convertirse en un plan de capacidades listo para implementar