Communitygithub.com

assafkip/claude-video-editor

Crea composiciones, animaciones, tarjetas de título, superposiciones, subtítulos, voces en off, visuales reactivos al audio y transiciones de escena en HyperFrames HTML.

¿Qué es claude-video-editor?

Esta habilidad convierte a un agente de IA (como Claude Code, Cursor, Codex, etc.) en un editor de video basado en HTML que utiliza el marco HyperFrames. Permite la producción completa de videos sin depender de herramientas de edición tradicionales, trabajando directamente con código HTML, CSS y JavaScript. La habilidad cubre la creación de composiciones, animaciones, tarjetas de título, superposiciones, subtítulos sincronizados, voces en off mediante texto a voz, visuales reactivos al audio (como sincronización de ritmo y efectos de pulso) y transiciones entre escenas (fundidos, barridos, revelados). Para los comandos de línea de comandos como `init`, `lint`, `preview`, `render`, `transcribe` y `tts`, se debe consultar la habilidad `hyperframes-cli`. El flujo de trabajo incluye pasos rigurosos: definir una identidad visual a través de un DESIGN.md o guía de estilo, construir el diseño final primero antes de añadir animación, y seguir reglas estrictas de sincronización y animación para evitar conflictos y garantizar una salida determinista. Está diseñado para plataformas que soportan agentes de IA y permite la generación de contenido de video profesional desde cero.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/assafkip/claude-video-editor/tree/HEAD/skills/hyperframes

Preguntar en tu IA favorita

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

Vista previa

Del README del skill

Documentación

HyperFrames

HTML es la fuente de verdad para el video. Una composición es un archivo HTML con atributos data-* para la sincronización, una línea de tiempo de GSAP para la animación y CSS para la apariencia. El marco maneja la visibilidad de los clips, la reproducción de medios y la sincronización de la línea de tiempo.

Enfoque

Antes de escribir HTML, piensa a alto nivel:

  1. Qué — ¿qué debería experimentar el espectador? Identifica el arco narrativo, los momentos clave y los latidos emocionales.
  2. Estructura — cuántas composiciones, cuáles son subcomposiciones vs. en línea, qué pistas llevan qué (video, audio, superposiciones, subtítulos).
  3. Sincronización — qué clips impulsan la duración, dónde caen las transiciones, cuál es el ritmo.
  4. Diseño — construye el estado final primero. Consulta "Diseño antes de la animación" a continuación.
  5. Animar — luego añade movimiento usando las reglas a continuación.

Para ediciones pequeñas (corregir un color, ajustar la sincronización, añadir un elemento), salta directamente a las reglas.

Puerta de identidad visual

Verifica en este orden:

  1. ¿Existe DESIGN.md en el proyecto? → Léelo. Utiliza sus colores, fuentes, reglas de movimiento y restricciones de "Qué NO hacer" exactos.
  2. ¿Existe visual-style.md? → Léelo. Aplica su style_prompt_full y campos estructurados. (Nota: visual-style.md es un archivo específico del proyecto. visual-styles.md es la biblioteca de estilos con 8 preajustes nombrados — archivos diferentes).
  3. ¿El usuario nombró un estilo (p. ej., "Swiss Pulse", "oscuro y tecnológico", "marca de lujo")? → Lee visual-styles.md para los 8 preajustes nombrados. Genera un DESIGN.md mínimo con: ## Prompt de Estilo (un párrafo), ## Colores (3-5 valores hex con roles), ## Tipografía (1-2 familias de fuentes), ## Qué NO hacer (3-5 antipatrones).
  4. ¿Ninguno de los anteriores? → Haz 3 preguntas antes de escribir cualquier HTML:
    • ¿Cuál es el estado de ánimo? (explosivo / cinematográfico / fluido / técnico / caótico / cálido)
    • ¿Lienzo claro u oscuro?
    • ¿Algún color de marca, fuente o referencia visual específica? Luego genera un DESIGN.md mínimo a partir de las respuestas.

Cada composición debe rastrear su paleta y tipografía hasta un DESIGN.md, visual-style.md o una dirección explícita del usuario. Si estás recurriendo a #333, #3b82f6 o Roboto — te saltaste este paso.

Para valores predeterminados de movimiento, tamaño, patrones de entrada y easing — sigue house-style.md. El estilo de la casa maneja CÓMO se mueven las cosas. El DESIGN.md maneja CÓMO SE VEN las cosas.

Diseño antes de la animación

Posiciona cada elemento donde debería estar en su momento más visible — el fotograma donde está completamente ingresado, colocado correctamente y aún no saliendo. Escribe esto como HTML+CSS estático primero. Sin GSAP todavía.

Por qué esto importa: Si posicionas los elementos en su estado inicial animado (fuera de pantalla, escalados a 0, opacidad 0) y los interpolas a donde crees que deberían aterrizar, estás adivinando el diseño final. Las superposiciones son invisibles hasta que el video se renderiza. Al construir el estado final primero, puedes ver y solucionar problemas de diseño antes de añadir cualquier movimiento.

El proceso

  1. Identifica el fotograma héroe para cada escena — el momento en que la mayoría de los elementos son visibles simultáneamente. Este es el diseño que construyes.
  2. Escribe CSS estático para ese fotograma. El contenedor .scene-content DEBE llenar la escena completa usando width: 100%; height: 100%; padding: Npx; con display: flex; flex-direction: column; gap: Npx; box-sizing: border-box. Usa padding para empujar el contenido hacia adentro — NUNCA uses position: absolute; top: Npx en un contenedor de contenido. Los contenedores de contenido con posición absoluta se desbordan cuando el contenido es más alto que el espacio restante. Reserva position: absolute solo para elementos decorativos.
  3. Añade entradas con gsap.from() — anima DESDE fuera de pantalla/invisible HASTA la posición CSS. La posición CSS es la verdad fundamental; la interpolación describe el viaje para llegar allí.
  4. Añade salidas con gsap.to() — anima HASTA fuera de pantalla/invisible DESDE la posición CSS.

Ejemplo

/* scene-content llena la escena, el padding posiciona el contenido */
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px;
  gap: 24px;
  box-sizing: border-box;
}
.title {
  font-size: 120px;
}
.subtitle {
  font-size: 42px;
}
/* El contenedor se adapta a cualquier tamaño de escena (1920x1080, 1080x1920, etc.).
   El padding posiciona el contenido. Flex + gap maneja el espaciado. */

INCORRECTO — dimensiones fijas y posicionamiento absoluto:

.scene-content {
  position: absolute;
  top: 200px;
  left: 160px;
  width: 1920px;
  height: 1080px;
  display: flex; /* ... */
}
// Paso 3: Animar DENTRO de esas posiciones
tl.from(".title", { y: 60, opacity: 0, duration: 0.6, ease: "power3.out" }, 0);
tl.from(".subtitle", { y: 40, opacity: 0, duration: 0.5, ease: "power3.out" }, 0.2);
tl.from(".logo", { scale: 0.8, opacity: 0, duration: 0.4, ease: "power2.out" }, 0.3);

// Paso 4: Animar FUERA de esas posiciones
tl.to(".title", { y: -40, opacity: 0, duration: 0.4, ease: "power2.in" }, 3);
tl.to(".subtitle", { y: -30, opacity: 0, duration: 0.3, ease: "power2.in" }, 3.1);
tl.to(".logo", { scale: 0.9, opacity: 0, duration: 0.3, ease: "power2.in" }, 3.2);

Cuando los elementos comparten espacio a lo largo del tiempo

Si el elemento A sale antes de que el elemento B entre en la misma área, ambos deben tener posiciones CSS correctas para sus respectivos fotogramas héroe. El orden de la línea de tiempo garantiza que nunca coexistan visualmente — pero si te saltas el paso de diseño, no detectarás el caso en que se superpongan accidentalmente debido a un error de sincronización.

Qué cuenta como superposición intencional

Los efectos en capas (brillo detrás del texto, elementos de sombra, patrones de fondo) y los diseños apilados en Z (pilas de tarjetas, capas de profundidad) son intencionales. El paso de diseño se trata de detectar superposiciones no intencionales — dos titulares cayendo uno encima del otro, una estadística cubriendo una etiqueta, contenido que se sale del marco.

Atributos de datos

Todos los clips

AtributoObligatorioValores
idSíIdentificador único
data-startSíSegundos o referencia de ID de clip ("el-1", "intro + 2")
data-durationObligatorio para img/div/composicionesSegundos. Video/audio predeterminado a la duración del medio.
data-track-indexSíEntero. Los clips de la misma pista no pueden superponerse.
data-media-startNoDesplazamiento de recorte en la fuente (segundos)
data-volumeNo0-1 (predeterminado 1)

data-track-index no afecta la superposición visual — usa CSS z-index.

Clips de composición

AtributoObligatorioValores
data-composition-idSíID de composición único
data-startSíTiempo de inicio (composición raíz: usa "0")
data-durationSíTiene prioridad sobre la duración de la línea de tiempo de GSAP
data-width / data-heightSíDimensiones en píxeles (1920x1080 o 1080x1920)
data-composition-srcNoRuta al archivo HTML externo

Estructura de composición

Las subcomposiciones cargadas mediante data-composition-src usan un envoltorio <template>. Las composiciones independientes (el index.html principal) NO usan <template> — colocan el div data-composition-id directamente en <body>. Usar <template> en un archivo independiente oculta todo el contenido del navegador y rompe el renderizado.

Estructura de subcomposición:

<template id="my-comp-template">
  <div data-composition-id="my-comp" data-width="1920" data-height="1080">
    <!-- contenido -->
    <style>
      [data-composition-id="my-comp"] {
        /* estilos con ámbito */
      }
    </style>
    <script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/gsap.min.js"></script>
    <script>
      window.__timelines = window.__timelines || {};
      const tl = gsap.timeline({ paused: true });
      // interpolaciones...
      window.__timelines["my-comp"] = tl;
    </script>
  </div>
</template>

Cargar en la raíz: <div id="el-1" data-composition-id="my-comp" data-composition-src="compositions/my-comp.html" data-start="0" data-duration="10" data-track-index="1"></div>

Video y audio

El video debe ser muted playsinline. El audio es siempre un elemento <audio> separado:

<video
  id="el-v"
  data-start="0"
  data-duration="30"
  data-track-index="0"
  src="video.mp4"
  muted
  playsinline
></video>
<audio
  id="el-a"
  data-start="0"
  data-duration="30"
  data-track-index="2"
  src="video.mp4"
  data-volume="1"
></audio>

Contrato de línea de tiempo

  • Todas las líneas de tiempo comienzan { paused: true } — el reproductor controla la reproducción
  • Registra cada línea de tiempo: window.__timelines["<composition-id>"] = tl
  • El marco anida automáticamente las sublínas de tiempo — NO las agregues manualmente
  • La duración proviene de data-duration, no de la longitud de la línea de tiempo de GSAP
  • Nunca crees interpolaciones vacías para establecer la duración

Reglas (No negociables)

Determinista: Sin Math.random(), Date.now() o lógica basada en tiempo. Usa un PRNG con semilla si necesitas valores pseudoaleatorios (p. ej., mulberry32).

GSAP: Solo anima propiedades visuales (opacity, x, y, scale, rotation, color, backgroundColor, borderRadius, transformaciones). NO animes visibility, display, ni llames a video.play()/audio.play().

Conflictos de animación: Nunca animes la misma propiedad en el mismo elemento desde múltiples líneas de tiempo simultáneamente.

Sin repeat: -1: Las líneas de tiempo con repetición infinita rompen el motor de captura. Calcula el número exacto de repeticiones a partir de la duración de la composición: repeat: Math.ceil(duration / cycleDuration) - 1.

Construcción síncrona de la línea de tiempo: Nunca construyas líneas de tiempo dentro de async/await, setTimeout o Promesas. El motor de captura lee window.__timelines sincrónicamente después de la carga de la página. Las fuentes están incrustadas por el compilador, por lo que están disponibles de inmediato — no es necesario esperar a que se carguen las fuentes.

Nunca hagas:

  1. Olvidar el registro de window.__timelines
  2. Usar video para audio — siempre video silenciado + <audio> separado
  3. Anidar video dentro de un div con tiempo — usa un envoltorio sin tiempo
  4. Usar data-layer (usa data-track-index) o data-end (usa data-duration)
  5. Animar las dimensiones del elemento de video — anima un div envoltorio
  6. Llamar a play/pause/seek en medios — el marco controla la reproducción
  7. Crear un contenedor de nivel superior sin data-composition-id
  8. Usar repeat: -1 en cualquier línea de tiempo o interpolación — siempre repeticiones finitas
  9. Construir líneas de tiempo asincrónicamente (dentro de async, setTimeout, Promise)
  10. Usar gsap.set() en elementos de clip de escenas posteriores — no existen en el DOM en la carga de la página. Usa tl.set(selector, vars, timePosition) dentro de la línea de tiempo en o después del tiempo data-start del clip.
  11. Usar <br> en el texto del contenido — los saltos de línea forzados no consideran el ancho de fuente renderizado real. El texto que se ajusta naturalmente + un <br> produce un salto adicional no deseado, causando superposición. Deja que el texto se ajuste mediante max-width. Excepción: títulos de pantalla cortos donde cada palabra está deliberadamente en su propia línea (p. ej., "THE\nIMMORTAL\nGAME" a 130px).

Transiciones de escena (No negociables)

Cada composición de múltiples escenas DEBE seguir TODAS estas reglas. Violar cualquiera de ellas es una composición rota.

  1. SIEMPRE usa transiciones entre escenas. Sin cortes abruptos. Sin excepciones.
  2. SIEMPRE usa animaciones de entrada en cada escena. Cada elemento anima ENTRADA mediante gsap.from(). Ningún elemento puede aparecer completamente formado. Si una escena tiene 5 elementos, necesita 5 interpolaciones de entrada.
  3. NUNCA uses animaciones de salida excepto en la escena final. Esto significa: NO gsap.to() que anime la opacidad a 0, y fuera de pantalla, escala a 0, o cualquier otra animación de "salida" antes de que se active una transición. La transición ES la salida. El contenido de la escena saliente DEBE estar completamente visible en el momento en que comienza la transición.
  4. Solo escena final: La última escena puede desvanecer elementos (p. ej., fundido a negro). Esta es la ÚNICA escena donde se permite gsap.to(..., { opacity: 0 }).

INCORRECTO — animación de salida antes de la transición:

// PROHIBIDO — esto vacía la escena antes de que la transición pueda usarla
tl.to("#s1-title", { opacity: 0, y: -40, duration: 0.4 }, 6.5);
tl.to("#s1-subtitle", { opacity: 0, duration: 0.3 }, 6.7);
// la transición se activa en un fotograma vacío

CORRECTO — solo entrada, la transición maneja la salida:

// Animaciones de entrada de la escena 1
tl.from("#s1-title", { y: 50, opacity: 0, duration: 0.7, ease: "power3.out" }, 0.3);
tl.from("#s1-subtitle", { y: 30, opacity: 0, duration: 0.5, ease: "power2.out" }, 0.6);
// SIN interpolaciones de salida — la transición en 7.2s maneja el cambio de escena
// Animaciones de entrada de la escena 2
tl.from("#s2-heading", { x: -40, opacity: 0, duration: 0.6, ease: "expo.out" }, 8.0);

Barreras de protección de animación

  • Desplaza la primera animación 0.1-0.3s (no t=0)
  • Varía los eases entre las interpolaciones de entrada — usa al menos 3 eases diferentes por escena
  • No repitas un patrón de entrada dentro de una escena
  • Evita degradados lineales de pantalla completa sobre fondos oscuros (bandas H.264 — usa radial o sólido + brillo localizado)
  • Titulares de 60px+, cuerpo de 20px+, etiquetas de datos de 16px+ para video renderizado
  • font-variant-numeric: tabular-nums en columnas de números

Cuando no se proporcione visual-style.md o dirección de animación, sigue house-style.md para los valores predeterminados estéticos.

Tipografía y recursos

  • Fuentes: Simplemente escribe la font-family que desees en CSS — el compilador incrusta las fuentes compatibles automáticamente. Si una fuente no es compatible, el compilador advierte.
  • Añade crossorigin="anonymous" a medios externos
  • Para

…

[truncated for translation]

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

assafkip/claude-video-editor

Build videos from stills when there is nothing to cut — narration first (ElevenLabs v3 with audio tags), then still keyframes from ANY source (AI image tools, screenshots, photos, HyperFrames-rendered HTML), animated deterministically with the animate-stills recipe (HyperFrames camera moves + GSAP atmosphere). Use when the user wants an explainer, documentary-style video, or any video built from generated or collected visuals instead of recorded footage.

assafkip/claude-video-editor

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

assafkip/claude-video-editor

HyperFrames CLI tool — hyperframes init, lint, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Use when scaffolding a project, linting or validating compositions, previewing in the studio, rendering to video, transcribing audio, generating TTS, or troubleshooting the HyperFrames environment.

assafkip/claude-video-editor

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

assafkip/claude-video-editor

Beginner-friendly end-to-end video creator for HyperFrames. Use when the user says "make a video", "create a video", "new video", "build a video", "video from scratch", "I want to make a video", "help me create a video", or when someone who's never used HyperFrames before arrives with a concept, script, or rough idea and wants a finished MP4. Interviews the user in one pass, then builds the full video with mandatory preview and visual-verification gates.

assafkip/claude-video-editor

Build and iterate short-form vertical (9:16) videos in Hyperframes — TikTok/Reels/Shorts style. Use when Nate says "short-form video", "vertical video", "TikTok/Reels/Shorts", "make a short", "talking-head + motion graphics", or when the target is a 1080x1920 composition with face video + synced scene overlays + karaoke captions. Encodes the full May Shorts 19 playbook: face-mode choreography, audio-synced scene timing, karaoke captions, and the 10-rule quality checklist.

assafkip/claude-video-editor

Edit any video by conversation — the orchestrator for the bundled video pipeline. Use when the user wants to edit, cut, caption, grade, or add motion graphics to footage; drops a folder of clips and says "edit this"; or asks to make a promo/teaser/tutorial/short. Routes to video-use (the cut engine) and HyperFrames (motion-graphics overlays), with a motion-craft library for taste.

assafkip/claude-video-editor

Production pipeline for mathematical and technical animations using Manim Community Edition. Creates 3Blue1Brown-style explainer videos, algorithm visualizations, equation derivations, architecture diagrams, and data stories. Use when users request: animated explanations, math animations, concept visualizations, algorithm walkthroughs, technical explainers, 3Blue1Brown style videos, or any programmatic animation with geometric/mathematical content.

assafkip/claude-video-editor

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

Skills relacionados