theus-cli 0.2.83 → 0.2.85

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

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

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