Communitygithub.com

assafkip/claude-video-editor

Creador de video integral para principiantes en 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 llegue con un concepto, guion o idea general y quiera un MP4 terminado. Entrevista al usuario en una sola pasada y luego construye el video completo con puertas de previsualización y verificación visual obligatorias.

¿Qué es claude-video-editor?

Esta habilidad ofrece un flujo de trabajo completo y guiado para que cualquier persona, incluso sin experiencia previa, pueda crear un video terminado en formato MP4 usando HyperFrames. El proceso se divide en dos fases: una entrevista conversacional (Puertas 1 a 4) para recopilar todos los detalles del proyecto (intención, formato, guion, estilo, recursos) y una fase de construcción (Puertas 5 a 8) que genera el video de manera estructurada y verificable. La habilidad está diseñada para funcionar con Claude Code, Cursor, Codex u otros asistentes de IA compatibles con HyperFrames, y se basa en reglas estrictas que incluyen la creación de un brief detallado, un storyboard por escenas y la verificación visual obligatoria mediante capturas de fotogramas. No se permite saltar pasos: cada puerta produce un artefacto concreto (BRIEF.md, STORYBOARD.md, composiciones, renders de prueba) y requiere la aprobación explícita del usuario antes de avanzar, garantizando así un control de calidad riguroso y la entrega de un video profesional.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/assafkip/claude-video-editor/tree/HEAD/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 puertas secuenciales. Cada puerta produce un artefacto concreto que la siguiente puerta consume. No omitas puertas.

Cuándo usar esta habilidad — y cuándo transferir

Usa esta habilidad cuando:

  • El usuario sea nuevo en HyperFrames y esté partiendo de un concepto, guion o esquema.
  • Quiera un tutorial completo, no material de referencia del framework.
  • Aún no haya decidido el formato.

Transfiere cuando:

  • El usuario pegue una URL y quiera un video de ese sitio → invoca /website-to-hyperframes
  • El usuario quiera explícitamente un video vertical 9:16 con cámara frontal + superposiciones de escena → ejecuta las Puertas 1–4 aquí, luego invoca /short-form-video a partir de la Puerta 5.
  • El usuario pregunte por reglas del framework, no por un video → invoca /hyperframes

Las dos fases

  • Fase 1 — ENTREVISTA (Puertas 1–4): una sola pasada conversacional para recopilar todo antes de tocar código. Intención, formato, guion, voz, estilo, recursos, ritmo. Sintetiza en un BRIEF.md y espera la aprobación explícita.
  • Fase 2 — CONSTRUCCIÓN (Puertas 5–8): andamio → storyboard → composiciones → lint → vista previa Studio → render 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? (promocional · anuncio social · teaser de lanzamiento · demo de producto · tutorial · explicativo · tarjeta de intro/outro · otro)
  2. ¿Quién es la audiencia? (respuesta libre)
  3. ¿Duración objetivo? (corto 10–20 s · promocional 20–45 s · explicativo 45–90 s · 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 IU 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 frontal, planea transferir a /short-form-video en la Puerta 5.

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


Puerta 2 · Guion y voz

  1. ¿Fuente del guion? (pegar · esquema → yo redacto · yo grabo · TTS desde texto · sin narración)
  2. Si es TTS: preferencia de voz. Ofrece opciones desde npx hyperframes tts --help. También captura el ritmo.
  3. Si es cámara frontal: ruta de grabación · pantalla completa o ubicación en esquina · ¿necesita transcripción? (npx hyperframes transcribe <archivo> --model small.en --json)
  4. ¿Subtítulos? (desactivados · atractivos · corporativos · karaoke palabra por palabra · mínimos)

Puerta: guion capturado (o redactado), plan de audio capturado, plan de subtítulos capturado.


Puerta 3 · Captura de estilo

Antes de preguntar nada al usuario, inventaría los recursos 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 todo:

  1. ¿Guía de estilo o documento de marca? (pegar/ruta · no)
  2. ¿Paleta de colores? (códigos hex · ninguno — usa valores predeterminados de MOTION_PHILOSOPHY)
  3. ¿Fuentes? (nombre(s) de Google Fonts · rutas de archivo · ninguna — usa valores predeterminados Inter + JetBrains Mono)
  4. ¿Archivo de logotipo? (ruta · ninguno — usa marca de texto)
  5. ¿Videos de referencia para el estilo? (URLs/rutas · ninguno)
  6. ¿Otros recursos? (capturas de pantalla · fotos de producto · material complementario · música — lista de rutas)
  7. Estética MOTION_PHILOSOPHY (lienzo negro · texto cromado · cuadrícula de perspectiva · transiciones whip) o un estilo diferente?
  8. ¿Ritmo? (cinético 1–2 s · equilibrado 2–3 s · relajado 3–5 s)
  9. ¿Música? (ninguna · pad ambiental 0.15 · cama musical 0.4 · completa 0.8 — ruta de archivo si 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 rechacen explícitamente proporcionar un estilo.

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


Puerta 4 · Síntesis del brief (PUERTA ESTRICTA antes de construir)

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

Puerta 5 · Andamio y storyboard

Primero, verifica la transferencia

Si el brief describe un video vertical 9:16 con cámara frontal + superposiciones de escena, invoca /short-form-video AHORA y transfiere el brief. Su andamio de 4 capas está diseñado para ese formato.

De lo contrario, continúa:

Andamio

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

Storyboard

Genera <project-folder>/STORYBOARD.md usando la plantilla en references/storyboard-template.md. Cada escena obtiene:

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

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

Propón una estructura de tres actos:

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

(MOTION_PHILOSOPHY §0 Ley 9, §1.)

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

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


Puerta 6 · Construir composiciones

Invoca /hyperframes para las reglas del framework. Esta habilidad posee el andamio y la disciplina; /hyperframes aplica las reglas.

Andamio 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 });
      // ... tweens ...
      tl.to({}, { duration: SLOT_DURATION }, 0);   // ancla — MOTION_PHILOSOPHY Ley 11
      window.__timelines["scene-name"] = tl;
    })();
  </script>
</div>

Código base completo + 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: escalonado por palabra 0.06–0.10 s.
  • 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 las escenas (MOTION_PHILOSOPHY §3.13).
  • Bloques del catálogo instalados mediante npx hyperframes add <nombre>. Inmediatamente limita 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 frontal: envuelve el rostro nativo 1920×1080 en una transformación (translate + scale) para modo mitad inferior o pantalla completa. (Si terminas aquí en lugar de en /short-form-video, considera seriamente la transferencia).
  • Aplica SOLO lo que el usuario proporcionó. Su paleta, sus fuentes, su logotipo. No inyectes nada más. Si eligieron los valores predeterminados de MOTION_PHILOSOPHY, toma la paleta y el par de fuentes de references/style-intake.md.

Determinismo

No uses Math.random(), no uses Date.now(), no uses fetch() en tiempo de render. Usa PRNGs con semilla o hashes seno-armónicos (MOTION_PHILOSOPHY §3.10).


Puerta 7 · Lint → Vista previa Studio (PUERTA DE PREVISUALIZACIÓN 1 — OBLIGATORIA)

  1. npx hyperframes lint — corrige todos los errores, clasifica las 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 junto con las URLs de composición individuales (http://localhost:3002/?comp=<id>). Si el proyecto tiene bloques de sombreado WebGL, comienza con las URLs individuales — la alternativa WebGL por software puede bloquear la composición maestra.
  5. ESPERA un "se ve bien, renderiza un borrador" explícito antes de continuar. El silencio no es aprobación.

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


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

Render borrador

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

Verificación visual (OBLIGATORIA antes de la entrega)

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

  1. mkdir -p renders/frames
  2. Para cada momento clave de escena 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 solo enumeres 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 (PUERTA DE PREVISUALIZACIÓN 2 — OBLIGATORIA)

npx serve renders -p 8080 -n

NO uses http.server de Python — no admite solicitudes HTTP Range, por lo que la reproducció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

Informa la ruta de salida. Listo.

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


Innegociables (críticos — no los suavices)

  • NO omitas la PUERTA DE PREVISUALIZACIÓN 1 (Studio) ni la PUERTA DE PREVISUALIZACIÓN 2 (MP4 renderizado). Dos puertas por construcción, siempre.
  • NO afirmes que un render está listo hasta que los fotogramas se hayan extraído Y leído mediante la herramienta Read.
  • NO construyas fuera de una carpeta de proyecto dedicada. Nunca pongas index.html en la raíz del workspace.
  • NO le pidas recursos al usuario antes de inventariar su workspace.
  • NO omitas el tween 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 rechacen 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 escena por escena + ejemplo resuelto
  • references/composition-scaffold.md — estilos con ámbito + código base GSAP IIFE
  • references/build-checklist.md — compuertas prevuelo y preentrega

Externas (a nivel de workspace):

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

Habilidades relacionadas

  • /hyperframes — reglas del framework, invoca 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 — transfiere en la Puerta 5 para formato vertical 9:16 con cámara frontal
  • /website-to-hyperframes — transfiere en la Puerta 1 si la entrada inicial es una URL

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

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For CLI commands (init, lint, preview, render, transcribe, tts) see the hyperframes-cli skill.

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