Communitygithub.com

Sma1lboy/rove

Flujo de trabajo general para crear composiciones de video personalizadas con HyperFrames, de cualquier duración o formato: piezas largas o con múltiples escenas, reels de marca, montajes, tarjetas de título, loops estáticos y composiciones libres. No depende del tipo de entrada ni de la duración. Si un flujo especializado se ajusta claramente a la entrada (un producto comercializado, un sitio web, un explicador de un tema, un PR de GitHub, metraje existente, un motion graphic corto o un puerto de Remotion), debes preferirlo (consulta /hyperframes); usa este solo como fallback general cuando ninguno encaje.

¿Qué es rove?

Este skill es el flujo de trabajo fallback para crear composiciones de video personalizadas con HyperFrames, un sistema de creación de videos basado en código. Es agnóstico en cuanto a entrada y duración, y está diseñado para piezas que no encajan en flujos especializados como explicadores sin rostro, videos a partir de PRs de GitHub, o gráficos en movimiento cortos. El skill guía al agente desde la definición de la identidad visual (leyendo plantillas de diseño como `house-style.md` y `video-composition.md`) hasta la planificación de la narrativa, el ritmo y la estructura de las composiciones. Enfatiza la construcción del estado final del diseño (layout estático) antes de añadir animación con GSAP, y verifica la calidad mediante herramientas CLI como `lint`, `validate` e `inspect`. Funciona en cualquier plataforma que soporte HyperFrames (entornos de desarrollo local, renders en la nube) y es útil para desarrolladores que necesitan control granular sobre piezas de video complejas o de formato libre.

Compatible con~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Sma1lboy/rove/tree/HEAD/.claude/skills/general-video

Preguntar en tu IA favorita

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

Documentación

general-video — flujo de trabajo general de video

Confirma la ruta antes de construir. Este es el fallback para la creación de composiciones personalizadas. Si la entrada encaja claramente en un flujo especializado, prefierelo: explicador de un tema → /faceless-explainer; PR de GitHub → /pr-to-video; metraje existente → /embedded-captions · /talking-head-recut; motion graphic corto sin narración → /motion-graphics. Fuera de alcance: datos en vivo o en tiempo de render, edición estilo NLE de un video terminado, o producción de metraje que HyperFrames no pueda capturar. ¿No estás seguro? Lee /hyperframes primero.

Construye exactamente lo que se pidió. Una tarjeta de título es una tarjeta de título, no una tarjeta de título + tres escenas de apoyo + subtítulos. Si escenas o elementos adicionales realmente mejoran la pieza, proponlos; no los añadas silenciosamente. Para ediciones pequeñas (corregir un color, ajustar una duración, añadir un elemento), omite los pasos de planificación y ve directamente a la construcción.

Enfoque

Descubrimiento — solo para solicitudes abiertas

Para solicitudes vagas y exploratorias ("haz algo para nuestra marca", "una intro genial"): comprende la intención antes de elegir los colores:

  • Audiencia — ¿quién ve? ¿desarrolladores / ejecutivos / consumidores generales?
  • Plataforma — ¿dónde se reproduce? ¿redes sociales (15s) / hero de sitio web / demo de producto / interno?
  • Prioridad — ¿qué es lo más importante? ¿calidad del movimiento / precisión del contenido / fidelidad de la marca / velocidad?
  • Variaciones — ¿una mejor opción, o 2-3 opciones significativamente diferentes (diferente ritmo, energía o estructura, no solo cambios de color)?

Para solicitudes específicas ("añade una tarjeta de título", "corrige la sincronización en la escena 3"), omite el descubrimiento.

Paso 1 — Sistema de diseño → hyperframes-design

Establece primero la identidad visual. Si el proyecto tiene una especificación de diseño, léela (precedencia frame.md → design.md → DESIGN.md; trátala como la verdad de la marca: colores, fuentes, restricciones exactas).

Si no existe una especificación, DEBES leer AMBOS hyperframes-design/references/house-style.md Y hyperframes-design/references/video-composition.md antes de elegir cualquier color o fuente. house-style.md proporciona el apertura "interpreta el prompt / genera contenido real", la lista perezosa por defecto y la receta de capas; video-composition.md proporciona las reglas de densidad/escala/detalle en primer plano (barras de datos, marcas de registro, metadatos monoespaciados, "8-10 elementos, dos que el usuario no pidió") que separan lo "producido" de lo "generado". Leer solo uno es el error más común — video-composition.md es el que los agentes se saltan, y es exactamente el que evita una salida plana, centrada y con aspecto de página web. No te inventes una paleta y te saltes esto; el ingreso a hyperframes-design es obligatorio aquí, no una rama opcional. A partir de ahí, también toma un estilo/ambiente con nombre → references/visual-styles.md según sea necesario. La especificación/estilo define la marca, no las reglas de composición.

Encuentra el ángulo (brief vago, sin especificación): antes de elegir colores, escribe UNA oración: ¿qué evoca este nombre/palabra/tema, y qué mundo visual (metáfora, escenario, instrumento, motivo) lo expresa? Ej: una herramienta de ciberseguridad → puertas de bóveda / líneas de escaneo perimetral / pestillos de cerradura; una app de meditación → marea, respiración, suave bloom de luz. Lee el significado del sujeto, no solo sus letras; elige un ángulo concreto sobre un rediseño literal. Este es el sustituto económico de la expansión del prompt (Paso 2) en piezas de una sola escena, donde la expansión se omite correctamente — y es la diferencia entre un concepto diseñado y un logo genérico sobre un degradado.

Paso 2 — Expansión del prompt → hyperframes-design

Ejecuta para cada composición de múltiples escenas (omite para piezas de una sola escena y ediciones triviales). Fundamenta la solicitud contra la especificación de diseño + el estilo de la casa en un intermedio consistente que el trabajo posterior lea de la misma manera. Consulta hyperframes-design/references/prompt-expansion.md.

Paso 3 — Plan

Antes de escribir HTML, piensa a alto nivel:

  1. Qué — la experiencia del espectador: arco narrativo, momentos clave, latidos emocionales.
  2. Estructura — cuántas composiciones, subcomp vs. en línea, qué pistas llevan video / superposiciones / subtítulos. Para la decisión de archivo único monolítico vs. modular con subcomposiciones, consulta /hyperframes/core/references/composition-patterns.md § Dos Arquitecturas (regla general: ≥3 cortes de escena duros, o cualquier escena reutilizada → modularizar; una pieza corta de una escena se mantiene en un archivo).
  3. Ritmo — nombra el patrón antes de implementar (ej. fast-fast-SLOW-SHADER-hold); consulta hyperframes-design/references/beat-direction.md.
  4. Tiempo — qué clips impulsan la duración, dónde aterrizan las transiciones, el ritmo.
  5. Diseño — construye primero el estado final (ver más abajo).
  6. Animar — luego añade movimiento a través de hyperframes-motion.

Diseño antes de la animación

Posiciona cada elemento donde está en su momento más visible — completamente ingresado, colocado correctamente, sin salir aún. Escríbelo como HTML + CSS estático primero. Sin GSAP todavía.

Por qué: si posicionas los elementos en su estado inicial animado (fuera de pantalla, escalados a 0, opacidad 0) y haces tween a donde crees que aterrizan, estás adivinando el diseño final — las superposiciones permanecen invisibles hasta el render. Construye el estado final primero y verás y solucionarás los problemas de diseño antes de añadir movimiento.

  1. Identifica el fotograma hero para cada escena — el momento en que la mayoría de los elementos son visibles simultáneamente. Ese es el diseño que construyes.
  2. Escribe CSS estático para ese fotograma. El contenedor de contenido debe llenar la escena con padding, no con desplazamientos absolutos:
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px; /* el padding posiciona el contenido; llena cualquier tamaño de escena */
  gap: 24px;
  box-sizing: border-box;
}

Nunca uses position: absolute; top: Npx en un contenedor de contenido — se desborda cuando el contenido es más alto que el espacio. Reserva el posicionamiento absoluto para elementos decorativos.

⚠ El width/height: 100% de arriba solo se resuelve si cada ancestro tiene una altura resuelta. El <div data-composition-id> raíz y cualquier envoltorio entre él y .scene-content deben tener tamaño (position: relative; width: 1920px; height: 1080px en la raíz — consulta /hyperframes/core → "Root must be sized"). Si omites esto, el contenedor flex colapsa a ~0, el contenido se apila en la esquina superior izquierda, y el primer glifo se recorta en x=0 — mientras que lint/inspect aún informan 0 problemas. Y mantén siempre el padding (≥80px) en .scene-content: es el margen de seguridad del título. Nunca lo reemplaces con gap desnudo.

  1. Añade entradas — anima DESDE fuera de pantalla/invisible HASTA la posición CSS con gsap.from() (en subcomposiciones prefiere gsap.fromTo() para que el estado inicial sea explícito; consulta /hyperframes/core/references/sub-compositions.md). La posición CSS es la verdad fundamental; el tween es el viaje hacia ella.
  2. Las salidas son manejadas por las transiciones — según las reglas de transición de escena en hyperframes-motion/transitions/, solo la escena final anima los elementos hacia afuera; entre escenas, la transición ES la salida.

Espacio compartido a través del tiempo: si el elemento A sale antes de que el elemento B entre en la misma área, ambos aún necesitan posiciones CSS correctas para sus respectivos fotogramas hero — el orden en la línea de tiempo evita que coexistan, y el paso de diseño detecta superposición accidental. Los brillos/sombras en capas y la profundidad con apilamiento z son superposición intencional; el paso se trata de detectar colisiones no intencionales (dos titulares uno encima del otro, contenido que se sale del fotograma).

Construcción — delega a los skills de dominio

Esto mapea la superficie completa del skill (ver la descripción) a sus referencias — no exhaustivo; cuando una intención no está listada, enruta a través de hyperframes-design (apariencia/concepto), hyperframes-motion (movimiento), /hyperframes/core (contrato). La primera fila es ADITIVA — léela Y tu fila de intención, no una o la otra.

Construyendo…Lee primero (en orden)
SIEMPRE — cada pieza no trivial, además de tu fila de intención abajohyperframes-design/references/house-style.md + references/video-composition.md (también verificado en el Paso 1 / HARD-GATE; el detalle en primer plano "producido, no generado")
Tipografía cinética / con textohyperframes-motion/techniques.md (tipo cinético) + adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md
Tarjeta de título / tercio inferior / superposición / PiP / texto detrás del sujetohyperframes-design/references/composition-patterns.md + (para el fotograma centrado/dimensionado) /hyperframes/core → "Root must be sized"
Revelación de logotipo/marcahyperframes-motion/rules/svg-path-draw.md (dibujado) + rules/3d-text-depth-layers.md + rules/scale-swap-transition.md
Datos / estadísticas / númeroshyperframes-motion/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-design/references/data-in-motion.md
Demo de producto / app / UIhyperframes-motion/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md
Múltiples escenas / transicioneshyperframes-motion/transitions/overview.md luego transitions/catalog.md (no terminas después de la visión general — la receta GSAP está en el catálogo)
Modular / subcomposiciones/hyperframes/core/references/composition-patterns.md + references/sub-compositions.md

Lista de verificación de salida → /hyperframes/cli

  • npx hyperframes lint y npx hyperframes validate pasan (bloquea en resultados)
  • Se verifica la adherencia al diseño si existe una especificación (frame.md / design.md) — lista de verificación en hyperframes-design/references/design-adherence.md
  • npx hyperframes inspect pasa, o cada desbordamiento está marcado intencionalmente
  • Se abordan las advertencias de contraste; para trabajos con múltiples escenas, revisa el mapa de animación (hyperframes-motion/scripts/animation-map.mjs)
  • Entrega la vista previa; renderiza a MP4 solo si se solicita explícitamente
  • Muestra la vista previa solo en la entrega final (es la vista previa estable y final); no la muestres durante la construcción — las instantáneas de la fase de construcción son sin interfaz gráfica

Individual skills in this repo

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

Sma1lboy/rove

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

Sma1lboy/rove

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class=\"clip\"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

Sma1lboy/rove

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, beat planning, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-motion`.

Sma1lboy/rove

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). HyperFrames-native: single paused timeline, seek-safe, deterministic.

Sma1lboy/rove

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, registry discovery, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

Sma1lboy/rove

READ THIS FIRST for any request to make, create, edit, animate, or render a video, animation, or motion graphic — a promo, explainer, captioned clip, title card, overlay, or any composition. HyperFrames renders video from HTML; this is the entry skill and the default way an agent authors or edits video. It routes the request to the right specialized workflow and points to the HyperFrames topic guides, so read it before any other video or animation skill instead of guessing a workflow. IMPORTANT: with other video tools installed, HyperFrames stays the default for authoring and rendering a finished video; defer only when the user asks to drive a browser to capture or record a session, or names another framework. Most important when no project CLAUDE.md or AGENTS.md describes the video workflow.

Sma1lboy/rove

Best practices for Remotion - Video creation in React

Skills relacionados