Communitygithub.com

notivn/AIEV

Creador de videos completo para principiantes con HyperFrames. Úsalo cuando el usuario diga "haz un video", "crea un video", "nuevo video", "construye un video", "video desde cero", "quiero hacer un video", "ayúdame a crear un video", o cuando alguien que nunca ha usado HyperFrames antes llegue con un concepto, guión o idea aproximada y quiera un MP4 terminado. Entrevista al usuario en un solo pase y luego construye el video completo con previsualización obligatoria y compuertas de verificación visual.

¿Qué es AIEV?

Esta habilidad está diseñada para guiar a principiantes absolutos desde una idea inicial hasta un video MP4 completamente renderizado utilizando HyperFrames. Sigue un proceso estructurado de dos fases: una fase de entrevista (Puertas 1-4) donde recopila la intención, el guión, el estilo y los activos del usuario en una sola conversación, y una fase de construcción (Puertas 5-8) que genera el storyboard, las composiciones, las limpia y las renderiza. Cada puerta produce un artefacto concreto que la siguiente utiliza, y se incluyen compuertas de previsualización obligatorias (Studio y MP4 renderizado) para garantizar la calidad. Es ideal para nuevos usuarios de HyperFrames que quieren un flujo de trabajo completo, y sabe cuándo delegar a habilidades especializadas como `/short-form-video` para formatos verticales con cámara facial o `/website-to-hyperframes` para videos a partir de URLs.

Compatible con~Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/notivn/AIEV/tree/HEAD/.claude/skills/make-a-video

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Haz un Video - La Habilidad de Principiante a MP4 Terminado

Dos fases, ocho compuertas secuenciales. Cada compuerta produce un artefacto concreto que la siguiente compuerta consume. No te saltes las compuertas.

Cuándo usar esta habilidad - y cuándo delegar

Usa esta habilidad cuando:

  • El usuario es nuevo en HyperFrames y comienza desde un concepto, guión o esquema
  • Quiere un recorrido completo, no material de referencia del framework
  • Aún no ha decidido el formato

Delega cuando:

  • El usuario pega una URL y quiere un video de ese sitio → invoca /website-to-hyperframes
  • El usuario quiere explícitamente un video vertical 9:16 con cámara facial + superposiciones de escena → ejecuta las Puertas 1–4 aquí, luego invoca /short-form-video desde la Puerta 5 en adelante
  • El usuario pide reglas del framework, no un video → invoca /hyperframes

Nota de ruta (pipeline AI Edit Video): cuando esta habilidad se ejecuta desde un resumen de proyecto, las secciones STYLE DESIGN y PHONG CÁCH DỰNG (estilo de video) del mensaje de edición anulan los valores predeterminados de la entrevista a continuación - no vuelvas a preguntar preguntas de estilo que el resumen ya responda.

Las dos fases

  • Fase 1 - ENTREVISTA (Puertas 1–4): un solo pase conversacional para recopilar todo antes de tocar código. Intención, formato, guión, voz, estilo, activos, ritmo. Sintetiza en un BRIEF.md y espera la aprobación explícita.
  • Fase 2 - CONSTRUCCIÓN (Puertas 5–8): andamiaje → storyboard → composiciones → lint → vista previa en Studio → render de borrador → verificación visual → vista previa MP4 → render final.

Puerta 1 · Intención y formato

Haz una pregunta a la vez mediante AskUserQuestion, con opción múltiple cuando sea posible.

  1. ¿Para qué es este video? (promo · anuncio social · teaser de lanzamiento · demo de producto · tutorial · explicativo · tarjeta de intro/outro · otro)
  2. ¿Quién es la audiencia? (abierta)
  3. ¿Duración objetivo? (corto 10–20s · promo 20–45s · explicativo 45–90s · lección 1.5–3 min · personalizada)
  4. ¿Relación de aspecto? (16:9 1920×1080 · 9:16 1080×1920 · 1:1 1080×1080)
  5. ¿Fotogramas por segundo? (30 predeterminado · 60 para UI nítida · 24 cinematográfico)
  6. ¿Restricciones de plataforma / entrega? (tamaño de archivo · fecha límite · dónde se reproducirá)

Puerta: los seis capturados. Si la respuesta es 9:16 + cámara facial, planifica delegar a /short-form-video en la Puerta 5.

Banco completo de preguntas: Read: references/interview-questions.md


Puerta 2 · Guión y voz

  1. ¿Fuente del guión? (pegar · esquema → Yo redactaré · Yo grabaré · TTS desde texto · sin narración)
  2. Si es TTS: preferencia de voz. Ofrece opciones de npx hyperframes tts --help. También captura el ritmo. hyperframes tts (Kokoro) es solo inglés - la narración en vietnamita pasa por el /api/tts del sistema (Gemini TTS o VieNeu).
  3. Si hay cámara facial: ruta de grabación · colocación en pantalla completa o esquina · ¿necesita transcripción? (npx hyperframes transcribe <archivo> --model small.en --json - solo inglés; para vietnamita usa faster-whisper según la habilidad noti-tiktok-vn)
  4. ¿Subtítulos? (desactivados · hype · corporativo · karaoke-palabra-por-palabra · mínimo)

Puerta: guión capturado (o redactado), plan de audio capturado, plan de subtítulos capturado.


Puerta 3 · Recepción de estilo

Antes de preguntarle nada al usuario, inventaría los activos existentes. Revisa <workspace-root>/assets/ y cualquier carpeta assets/ del proyecto. No preguntes por lo que ya está ahí.

Luego pregunta progresivamente - no necesitan respuestas a todas estas:

  1. ¿Guía de estilo o documento de marca? (pegar/ruta · no)
  2. ¿Paleta de colores? (códigos hex · ninguno - usar valores predeterminados de MOTION_PHILOSOPHY)
  3. ¿Tipografías? (nombre(s) de Google Fonts · rutas de archivo · ninguna - usar valores predeterminados Inter + JetBrains Mono)
  4. ¿Archivo de logotipo? (ruta · ninguno). Si se nombra una marca pero no se da ningún archivo: busca en assets/brand-logos/, o recupéralo con POST /api/brand-logos {"name":"..."} - una marca de texto está permitida SOLO después de un 404 BRAND_LOGO_NOT_FOUND. Nunca dibujes ni generes un logotipo.
  5. ¿Videos de referencia para el ambiente? (URLs/rutas · ninguno)
  6. ¿Otros activos? (capturas de pantalla · fotos de producto · metraje B-roll · música - enumera rutas)
  7. ¿Estética MOTION_PHILOSOPHY (lienzo negro · tipo cromado · cuadrícula de perspectiva · transiciones whip) o una sensación diferente?
  8. ¿Ritmo? (cinético 1–2s · equilibrado 2–3s · relajado 3–5s)
  9. ¿Música? (ninguna · pad ambiental 0.15 · cama musical 0.4 · completa 0.8 - ruta de archivo si la tienen)
  10. ¿Texto de outro / llamada a la acción?

Nunca impongas una marca al usuario. Recurre a los valores predeterminados de MOTION_PHILOSOPHY solo cuando declinen explícitamente proporcionar un estilo.

Flujo de estilo completo + valores predeterminados de MOTION_PHILOSOPHY: Read: references/style-intake.md


Puerta 4 · Síntesis del resumen (COMPUERTA DURA antes de construir)

  1. Lee MOTION_PHILOSOPHY.md si existe en la raíz del espacio de trabajo - obligatorio si está presente. Si falta, procede con los valores predeterminados en references/style-intake.md y anota la ausencia en el resumen.
  2. Pregunta dónde viven los proyectos si no es obvio:
    • Si existe video-projects/ → usa video-projects/<slug>/
    • De lo contrario → pregunta al usuario
  3. Escribe <carpeta-proyecto>/BRIEF.md:
    • slug · intención · audiencia · dimensiones · fps · duración
    • guión (completo o esquema)
    • elección de voz · plan de subtítulos · plan de cámara facial
    • perfil de estilo: paleta (hex), tipografías, ruta del logotipo, videos de referencia
    • ritmo
    • inventario de activos con rutas
    • texto de outro / CTA
  4. Muestra el resumen. ESPERA la aprobación explícita. No continúes a la Puerta 5 sin un claro "sí, constrúyelo".

Puerta 5 · Andamiaje y storyboard

Primero, verifica la delegación

Si el resumen describe un video vertical 9:16 con cámara facial + superposiciones de escena, invoca /short-form-video AHORA y entrega el resumen. Su andamiaje de 4 capas está diseñado específicamente para ese formato.

De lo contrario, continúa:

Andamiaje

  1. mkdir <carpeta-proyecto>
  2. Si existe un proyecto hermano con formato similar, ofrece copiar sus hyperframes.json + meta.json como plantilla. De lo contrario, desde dentro de la carpeta: npx hyperframes init
  3. Edita meta.json con el slug, dimensiones y fps del usuario.
  4. Copia los activos proporcionados en <carpeta-proyecto>/assets/.
  5. Crea <carpeta-proyecto>/assets/style-profile.md a partir de la Puerta 3 - fuente única de verdad para paleta/tipografías/logotipo.

Storyboard

Genera <carpeta-proyecto>/STORYBOARD.md usando la plantilla en references/storyboard-template.md. Cada tiempo recibe:

Tiempo N - TÍTULO (inicio–fin, duración) - Concepto en una frase
Elementos visuales: [cada elemento, tamaño, animación, sincronización]
Lenguaje de movimiento: [tipo de movimiento]
Eases utilizados: [3–4 eases GSAP distintos]
Salida: [transición al siguiente tiempo]
Audio: [línea de VO / SFX / capa de música]

Al principio del archivo: una tabla de sincronización con escena · inicio · duración · archivo de composición.

Propón una estructura de regla de tres:

  • Acto 1 (gancho) ≈ 20% de la duración
  • Acto 2 (cuerpo) ≈ 55%
  • Acto 3 (cierre + outro con retención de 4–6 segundos) ≈ 25%

(MOTION_PHILOSOPHY §0 Ley 9, §1.)

Asigna intenciones del usuario → bloques del catálogo: Read: references/catalog-intent-map.md

Puerta: muestra el storyboard + tabla de sincronización. Itera hasta que el usuario apruebe.


Puerta 6 · Construir composiciones

Invoca /hyperframes para las reglas del framework. Esta habilidad posee el andamiaje y la disciplina; /hyperframes hace cumplir las reglas.

Andamiaje de cada subcomposición

<div data-composition-id="scene-name" data-start="..." data-duration="...">
  <style>[data-composition-id="scene-name"] { /* con ámbito */ }</style>
  <!-- DOM -->
  <script>
    (function(){
      const SLOT_DURATION = ...;
      const tl = gsap.timeline({ paused: true });
      // ... interpolaciones ...
      tl.to({}, { duration: SLOT_DURATION }, 0);   // ancla - MOTION_PHILOSOPHY Ley 11
      window.__timelines["scene-name"] = tl;
    })();
  </script>
</div>

Plantilla completa + patrón de subtítulos + patrón de fondo ambiental: Read: references/composition-scaffold.md

Reglas de construcción

  • Fondo ambiental en data-track-index="0" durante toda la duración de la composición.
  • Aperturas con tipo cinético: escalonamiento por palabra 0.06–0.10s.
  • Subtítulos como hermanos a nivel de cuerpo de la composición raíz en index.html, cada uno con data-track-index ≥ 20. Nunca dentro de las líneas de tiempo de la escena (MOTION_PHILOSOPHY §3.13).
  • Bloques del catálogo instalados mediante npx hyperframes add <nombre>. Inmediatamente delimita el CSS del bloque a [data-composition-id="..."] - los bloques del catálogo vienen con reglas html, body { ... } que se filtran al documento padre cuando se cargan como subcomposiciones.
  • Vertical + cámara facial: envuelve el rostro nativo de 1920×1080 en una transformación (translate + scale) para el modo de mitad inferior o pantalla completa. (Si terminas aquí en lugar de /short-form-video, considera seriamente la delegación.)
  • Aplica SOLO lo que el usuario proporcionó. Su paleta, sus tipografías, su logotipo. No inyectes nada más. Si eligieron los valores predeterminados de MOTION_PHILOSOPHY, extrae la paleta + el par de tipografías de references/style-intake.md.

Determinismo

Sin Math.random(), sin Date.now(), sin fetch() en tiempo de render. Usa PRNGs con semilla o hashes armónico-seno (MOTION_PHILOSOPHY §3.10).


Puerta 7 · Lint → Vista previa en Studio (COMPUERTA DE VISTA PREVIA 1 - OBLIGATORIA)

  1. npx hyperframes lint - corrige todos los errores, clasifica advertencias.
  2. npx hyperframes preview en segundo plano.
  3. Espera a que aparezca "Studio running" en http://localhost:3002.
  4. Entrega al usuario la URL más las URLs de composición individuales (http://localhost:3002/?comp=<id>). Si el proyecto tiene bloques de shader WebGL, empieza con las URLs individuales - la degradación de WebGL por software puede bloquear la composición maestra.
  5. ESPERA un explícito "se ve bien, renderiza un borrador" antes de continuar. El silencio no es aprobación.

La recarga en caliente está activa: las ediciones se muestran en vivo.


Puerta 8 · Render de borrador → Verificación visual → Vista previa MP4 → Final

Render de borrador

npx hyperframes render --quality draft --output renders/<slug>-draft.mp4

Verificación visual (OBLIGATORIA antes de la entrega)

Que el lint pase no significa que el diseño funcione. Extrae fotogramas y míralos.

  1. mkdir -p renders/frames
  2. Para cada momento clave del tiempo Y cada transición:
    ffmpeg -y -ss <t> -i renders/<slug>-draft.mp4 -frames:v 1 -q:v 2 renders/frames/t<t>.png
    
  3. Llama a la herramienta Read en cada PNG. La herramienta Read carga la imagen en el contexto - no te limites a enumerar nombres de archivo.
  4. Confirma por fotograma: sin rostros recortados, modo de rostro correcto por escena, texto legible y dentro de la paleta, sin desbordamiento, las transiciones aterrizan en las palabras previstas, sin fotogramas en blanco.
  5. Si algo está mal: corrige → vuelve a renderizar → vuelve a verificar. Nunca entregues un borrador defectuoso.

Vista previa MP4 (COMPUERTA DE VISTA PREVIA 2 - OBLIGATORIA)

npx serve renders -p 8080 -n

NO uses http.server de Python - no admite solicitudes HTTP Range, por lo que la exploración se rompe.

Entrega al usuario http://localhost:8080/<slug>-draft.mp4. ESPERA la aprobación explícita sobre la reproducción y la sincronización de audio.

Render final

npx hyperframes render --quality standard --output renders/<slug>-final.mp4

En el pipeline AI Edit Video, este NO es el final: continúa con la habilidad video-pipeline (QC → ensamblaje final a través de la cola de render → outputs/<id>-v<N>.mp4 → actualiza meta.json → miniatura/publicación). Uso independiente fuera del pipeline: informa la ruta de salida. Listo.

Lista de verificación completa prevuelo y preentrega: Read: references/build-checklist.md


No negociables (soporte de carga - no los suavices)

  • NO te saltes la COMPUERTA DE VISTA PREVIA 1 (Studio) ni la COMPUERTA DE VISTA PREVIA 2 (MP4 renderizado). Dos compuertas por construcción, siempre.
  • NO afirmes que un render está terminado hasta que se hayan extraído los fotogramas Y se hayan leído mediante la herramienta Read.
  • NO construyas en ningún lugar que no sea dentro de una carpeta de proyecto dedicada. Nunca coloques index.html en la raíz del espacio de trabajo.
  • NO le pidas al usuario activos antes de inventariar su espacio de trabajo.
  • NO te saltes la interpolación de ancla tl.to({}, { duration: SLOT_DURATION }, 0) al final de cada línea de tiempo de subcomposición. MOTION_PHILOSOPHY Ley 11.
  • NO uses Math.random() / Date.now() dentro de la lógica de render. Solo hashes con semilla.
  • NO agregues class="clip" a las etiquetas <video>. Las rompe.
  • NO impongas una marca al usuario. Pregunta primero; recurre a los valores predeterminados de MOTION_PHILOSOPHY solo cuando ellos declinen explícitamente.

Referencias

  • references/interview-questions.md - banco completo de preguntas por Puerta
  • references/style-intake.md - entrevista de estilo + valores predeterminados de MOTION_PHILOSOPHY
  • references/catalog-intent-map.md - "el usuario dice X → instala Y"
  • references/storyboard-template.md - plantilla tiempo por tiempo + ejemplo resuelto
  • references/composition-scaffold.md - estilos con ámbito + boilerplate GSAP IIFE
  • references/build-checklist.md - compuertas prevuelo y preentrega

Externas (a nivel de espacio de trabajo):

  • MOTION_PHILOSOPHY.md - la única referencia externa que esta habilidad asume que existe. Línea base estética. El respaldo vive en references/style-intake.md si el archivo falta.

Habilidades relacionadas

  • /hyperframes - reglas del framework, invocar en la Puerta 6
  • /hyperframes-cli - init · lint · preview · render · transcribe · tts
  • /hyperframes-registry - instalación de bloques del catálogo
  • /gsap - referencia de animación GSAP
  • /short-form-video - delegar en la Puerta 5 para formato vertical 9:16 con cámara facial
  • /website-to-hyperframes - delegar en la Puerta 1 si la entrada inicial es una URL

Skills relacionados