Communitygithub.com

1345AbhishekKumar/starter-supabase

El flujo de trabajo de respaldo para crear composiciones de video HyperFrames personalizadas, de cualquier longitud o formato: piezas largas o de múltiples escenas, reels de marca / sizzle, montajes, tarjetas de título, bucles estáticos y composiciones libres. Agnóstico a la entrada y duración. Si un flujo especializado se ajusta claramente a la entrada (producto comercializado, sitio web, explicador de temas, PR de GitHub, metraje existente, gráfico en movimiento corto o port de Remotion), úsalo (ver /hyperframes); usa este solo como respaldo general cuando ninguno encaje.

¿Qué es starter-supabase?

Este skill es el flujo de trabajo de respaldo para crear composiciones de video HyperFrames personalizadas, diseñado para manejar piezas de cualquier longitud o formato cuando ningún flujo especializado (como producto, sitio web o explicador) se ajusta. Es agnóstico a la entrada y se enfoca en la autoría de composiciones de video generales, desde tarjetas de título hasta reels de marca y montajes. El skill enfatiza un enfoque estructurado: primero establecer la identidad visual (diseño, colores, tipografía) y un ángulo conceptual, luego expandir el prompt para composiciones de múltiples escenas, planificar la estructura y el ritmo, y finalmente construir el diseño estático antes de agregar animación. Incluye pautas estrictas para evitar errores comunes, como omitir los archivos house-style.md y video-composition.md, que son críticos para lograr un resultado profesional y no genérico. El skill también integra un motor de audio unificado para TTS, BGM y SFX, y recomienda delegar tareas específicas (como transiciones o animaciones de datos) a skills de dominio especializados dentro del ecosistema HyperFrames.

Compatible con~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/1345AbhishekKumar/starter-supabase/tree/HEAD/.agents/skills/general-video

Preguntar en tu IA favorita

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

Documentación

media-use: Antes de obtener audio/imágenes, llama a /media-use para resolver BGM/SFX/imágenes del catálogo de HeyGen. Ejecuta --adopt primero para registrar activos existentes. Consulta el skill /media-use.

general-video — flujo de trabajo de video general

Confirma la ruta antes de construir. Este es el respaldo para la autoría de composiciones personalizadas. Si la entrada claramente encaja en un flujo de trabajo especializado, úsalo: producto comercializado → /product-launch-video; sitio general → /website-to-video; explicador de temas → /faceless-explainer; PR de GitHub → /pr-to-video; metraje existente → /embedded-captions · /talking-head-recut; gráfico en movimiento corto sin narración → /motion-graphics; port de Remotion → /remotion-to-hyperframes. Fuera de alcance: datos en vivo / al momento del render, edición estilo NLE de un video terminado, o producir 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 + música ambiental + subtítulos. Si escenas o elementos adicionales realmente mejorarían la pieza, propónlos; no los agregues en silencio. Para ediciones pequeñas (corregir un color, ajustar una duración, agregar un elemento), omite los pasos de planificación y ve directamente a la construcción.

Enfoque

Descubrimiento — solo solicitudes abiertas

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

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

Para solicitudes específicas ("agrega una tarjeta de título", "arregla el tiempo en la escena 3"), omite el descubrimiento.

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

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

Si no existe especificación, DEBES leer AMBOS hyperframes-creative/references/house-style.md Y hyperframes-creative/references/video-composition.md antes de elegir cualquier color o fuente. house-style.md da el iniciador de "interpreta la indicación / genera contenido real", la lista perezosa predeterminada y la receta de capas; video-composition.md da las reglas de densidad / escala / detallado de 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 omiten, y es exactamente el que evita una salida plana, centrada y parecida a una página web. No inventes una paleta por tu cuenta y omitas esto; cruzar a hyperframes-creative aquí es obligatorio, no una rama opcional. A partir de ahí, también obtén un estilo/estado de ánimo nombrado → references/visual-styles.md, o el selector interactivo → references/design-picker.md, según sea necesario. La especificación/estilo define la marca, no las reglas de composición.

Encuentra el ángulo (resumen vago, sin especificación): antes de elegir colores, escribe UNA oración — ¿qué evoca este nombre/palabra/tema, y qué mundo visual (metáfora, entorno, instrumento, motivo) lo expresa? Por ejemplo, una herramienta de ciberseguridad → puertas de bóveda / líneas de escaneo perimetral / pestillos de cerradura; una app de meditación → marea, respiración, floración de luz lenta. Lee el significado del tema, no solo sus letras; elige un ángulo concreto sobre un reestilo literal. Este es el sustituto barato de la expansión de indicaciones (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 logotipo genérico sobre un degradado.

Paso 2 — Expansión de indicación → hyperframes-creative

Ejecuta para cada composición de múltiples escenas (omite para piezas de una sola escena y ediciones triviales). Fundamenta la solicitud con la especificación de diseño + estilo de la casa en un intermedio consistente que los trabajos posteriores lean de la misma manera. Consulta hyperframes-creative/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, sub-comp vs en línea, qué pistas llevan video / audio / superposiciones / subtítulos. Para la decisión de archivo único monolítico vs sub-comp modular, 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 sola escena permanece en un archivo).
  3. Ritmo — nombra el patrón antes de implementar (por ejemplo, rápido-rápido-LENTO-SHADER-espera); consulta hyperframes-creative/references/beat-direction.md.
  4. Tiempo — qué clips impulsan la duración, dónde caen las transiciones, el ritmo.
  5. Diseño — construye el estado final primero (ver más abajo).
  6. Animar — luego agrega movimiento a través de hyperframes-animation.

Diseño antes de la animación

Posiciona cada elemento donde se encuentra en su momento más visible — completamente entrado, colocado correctamente, sin salir aún. Escribe eso como HTML + CSS estático primero. Aún no hay GSAP.

Por qué: si posicionas elementos en su estado inicial animado (fuera de pantalla, escalados a 0, opacidad 0) y interpolas hacia 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 agregar movimiento.

  1. Identifica el fotograma héroe 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 relleno, no desplazamientos absolutos:
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px; /* el relleno 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% anterior 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 → "La raíz debe tener tamaño"). Omite esto y el contenedor flexible colapsa a ~0, el contenido se amontona en la esquina superior izquierda, y el primer glifo se recorta en x=0 — mientras que lint/inspect aún informan 0 problemas. Y siempre mantén el padding (≥80px) en .scene-content: es el margen de seguridad del título. Nunca lo reemplaces con gap simple.

  1. Agrega entradas — anima DESDE fuera de pantalla/invisible HASTA la posición CSS con gsap.from() (en sub-composiciones 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 absoluta; la interpolación es el viaje hacia ella.
  2. Las salidas son manejadas por transiciones — según las reglas de transición de escena en hyperframes-animation/transitions/, solo la escena final anima los elementos hacia afuera; entre escenas, la transición ES la salida.

Espacio compartido a lo largo 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 héroe — el orden de la línea de tiempo evita que coexistan, y el paso de diseño detecta superposiciones accidentales. Los destellos/sombras en capas y la profundidad apilada en z son superposiciones intencionales; el paso se trata de detectar colisiones no intencionales (dos titulares uno sobre otro, contenido sangrando fuera del fotograma).

Construir — delegar a los skills de dominio

Esto mapea la superficie completa del skill (consulta la description) a sus referencias — no exhaustivo; cuando una intención no esté listada, enruta a través de hyperframes-creative (apariencia/concepto), hyperframes-animation (movimiento), hyperframes-core (contrato), hyperframes-media (audio/subtítulos). La primera fila es ADITIVA — léela Y tu fila de intención, no una u otra.

Construyendo…Lee primero (en orden)
SIEMPRE — cada pieza no trivial, además de tu fila de intención abajohyperframes-creative/references/house-style.md + references/video-composition.md (también exigido en el Paso 1 / HARD-GATE; los detalles de primer plano "producido, no generado")
Tipografía cinética / texto prominentehyperframes-animation/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-creative/references/composition-patterns.md + (para el fotograma centrado/dimensionado) hyperframes-core → "La raíz debe tener tamaño"
Revelación de logotipo / marcahyperframes-animation/rules/svg-path-draw.md (dibujado) + rules/3d-text-depth-layers.md + rules/scale-swap-transition.md
Datos / estadísticas / númeroshyperframes-animation/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-creative/references/data-in-motion.md
Demo de producto / app / UIhyperframes-animation/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md
Audio-reactivo / impulsado por músicahyperframes-creative/references/audio-reactive.md (pre-extraer bandas; mapear al movimiento)
Narrado / voz en off / música / SFX / subtítuloshyperframes-media → el motor de audio compartido scripts/audio.mjs (una llamada = TTS + BGM + SFX → audio_meta.json); autoría de subtítulos + colocación de activos a través de hyperframes-core. Consulta Audio abajo.
Múltiples escenas / transicioneshyperframes-animation/transitions/overview.md luego transitions/catalog.md (no has terminado después de la visión general — la receta GSAP está en el catálogo)
Modular / sub-composicioneshyperframes-core/references/composition-patterns.md + references/sub-compositions.md

Audio: un motor (TTS · BGM · SFX)

Solo cuando la pieza lo requiera (según "construye exactamente lo que se pidió" — nada de música ambiental en una tarjeta de título). No implementes TTS a mano ni contrates una copia: escribe un audio_request.json neutral y llama al motor compartido en hyperframes-media. Se degrada automáticamente en un interruptor: credencial de HeyGen presente → TTS de HeyGen + recuperación de música/SFX; ausente → TTS de ElevenLabs/Kokoro, generación de BGM de Lyria/MusicGen y la biblioteca SFX incluida. Lista completa de banderas + esquema de solicitud/meta: el comentario de encabezado de hyperframes-media/scripts/audio.mjs.

// audio_request.json — una línea por segmento narrado; `id` es tuyo (une audio_meta de vuelta)
{
  "lines": [
    { "id": "s1", "text": "Tu línea de apertura.", "sfx": ["whoosh"] },
    { "id": "s2", "text": "El siguiente compás." },
  ],
  "bgm": { "query": "subrayado calmado cinematográfico" }, // omite "mode" → auto (recuperar si HeyGen, si no generar); "none" para deshabilitar
}
# <MEDIA_DIR> = el directorio del skill hyperframes-media instalado (hermano de este skill)
node <MEDIA_DIR>/scripts/audio.mjs --request ./audio_request.json --hyperframes . --out ./audio_meta.json

Luego lee audio_meta.json: monta cada voices[].path + (bgm.path, sfx[]) como pistas <audio> y usa voices[].words para subtítulos, todo según hyperframes-core (pistas de audio + autoría de subtítulos). Si BGM tomó la ruta de generación (bgm_pending: true), ejecuta hyperframes-media/scripts/wait-bgm.mjs antes del render final.

Lista de verificación de salida → hyperframes-cli

  • Ejecuta --lint y --inspect desde la CLI antes del render final. inspect revela superposiciones, elementos fuera del fotograma y texto sangrante que el diseño estático no capturó. Soluciona los problemas, ejecuta --lint/--inspect de nuevo, solo entonces renderiza.
  • Confirma la licencia: la salida se considera una "obra creada" bajo la licencia del skill (MIT/permisiva; ver LICENSE). No se requiere atribución.

Apéndice: la analogía del diseñador

Los agentes que tratan la composición de video como si fueran diapositivas generan diapositivas, no video. video-composition.md existe porque eso es lo que separa "producido" de "generado". Piensa en el diseñador que:

  • Abre InDesign → coloca márgenes de sangrado y guías de cuadrícula antes de colocar cualquier contenido.
  • Nunca centra un logotipo en un campo vacío a menos que la marca lo exija.
  • Agrega marcas de registro, barras de datos, números de página, texto monoespaciado para metadatos — elementos que el espectador no "nota" pero que hacen que la pieza se sienta real.
  • Trata el borde como espacio utilizable, no como un lugar para evitar.
  • Elige una fuente de exhibición para el titular principal, no la primera fuente del sistema.

video-composition.md es ese diseñador. house-style.md es el briefing de la agencia. Lee ambos. No es opcional, y video-composition.md es, con mucho, el que los agentes omiten con más frecuencia — y por lo tanto, el error más común de todos.

Individual skills in this repo

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

1345AbhishekKumar/starter-supabase

Add captions to a talking-head video. ONE catalog (CATALOG.md) of 32 visual identities behind two engines: column-flow (captions composited INTO the scene — matte occlusion + mix-blend; cream/ink/editorial/keynote/documentary/loud/neon/glitch/chrome/velocity) and themed constitutions (anchor/ordnance/terminal/neonsign/stardust/stomp/scoreboard/transit/vhs/arcade/dossier/laser/thunder/hologram/biolume/aurora/spectrum/papercut/popup/chalkboard/graffiti/brush/inkwater/ransom/lastpage/nightcity — e.g. a glyph-decode climax, a neon sign WRITTEN stroke by stroke, or the quiet `anchor` rail default). Route by identity, never by mode. Trigger on "captions/subtitles", "embed/cinematic captions", "VFX captions", "炸/特效/酷炫字幕", a named identity, or top-tier motion-graphics asks. Embedding every word is wrong for most talking-head content — `anchor` is the verbatim default. Pipeline: transcription → hyperframes remove-background matting → HTML render → ffmpeg overlay. Requires hyperframes and a single-subject clip.

1345AbhishekKumar/starter-supabase

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.

1345AbhishekKumar/starter-supabase

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, tts, 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`).

1345AbhishekKumar/starter-supabase

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.

1345AbhishekKumar/starter-supabase

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

1345AbhishekKumar/starter-supabase

Audio and media assets for HyperFrames compositions, produced by one shared audio engine (`scripts/audio.mjs`) — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), background music + sound effects (HeyGen audio-library retrieval by default, with local Lyria / MusicGen BGM generation and a bundled SFX library as the no-credential fallback), Whisper transcription, background removal, and caption authoring. Use for voiceover / TTS, BGM, SFX / sound effects, transcription, captions / subtitles / lyrics / karaoke / per-word styling, voice + provider selection, and music-mood prompting.

1345AbhishekKumar/starter-supabase

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).

1345AbhishekKumar/starter-supabase

Use when the user wants a short, design-led motion graphic where motion is the message: kinetic typography, stat or number count-up, chart/data-viz hit, logo sting, brand lockup, lower-third, callout, social overlay, animated headline/tweet/news item, motion poster, or quick captured-page highlight. Usually under 10s and up to ~30s, with no narration arc, voice-over, or live-action subject. Can render to MP4 or transparent overlay. Not for longer, multi-scene, narrated, or brand-reel pieces (use general-video), narrated website videos (website-to-video), topic explainers (faceless-explainer), product promos (product-launch-video), PR videos (pr-to-video), or captions on existing footage (embedded-captions). When unsure whether it's a quick motion-first piece or a longer / narrated treatment, see /hyperframes.

1345AbhishekKumar/starter-supabase

Use when the user has a music track (an audio file, or a video to pull audio from) and wants a beat-synced HyperFrames video, calm to hard-hitting. The music drives everything: one analyzer reads it once, the orchestrator lays out the frames and fills a per-frame plan, and one sub-agent builds each frame. Typography and templates are the floor — a complete video needs zero assets — but any images or videos the user supplies are cut into the frames on the same beat grid (beat-cut / ken-burns). The genre (lyric video, slideshow, kinetic promo) falls out of the per-frame choices; the pipeline never branches on it.

1345AbhishekKumar/starter-supabase

turn a product or marketing URL, pasted script, or brief into a product launch video, including SaaS promos, feature reveals, app launches, company promos, and product marketing videos. Use this skill when the user wants to market, launch, promote, or reveal a product. Do not use it for general non-launch website tours, non-product topic explainers, GitHub pull requests, captioning existing footage, or short unnarrated motion graphics. If the intent is unclear, route through /hyperframes first. This is the new shot-sequence architecture: every visual frame is authored as a time-coded shot sequence picked from a menu of golden blueprints, so frames develop over their full duration instead of freezing after entrance.

1345AbhishekKumar/starter-supabase

turn a GitHub pull request (a PR URL like github.com/<owner>/<repo>/pull/<N>, an <owner>/<repo>#<N> ref, or 'this PR' in a checked-out repo) into a code-change explainer video, up to ~3 min (sweet spot 30-90s) — changelog, feature reveal, fix, or refactor walkthrough, rendered from the diff / commits / files. The input is a CODE CHANGE read via the gh CLI; there is no website capture. Use this skill for a GitHub PR. Do not use it for a product launch/promo (use /product-launch-video), a tour of a real website (use /website-to-video), a topic explainer with no PR (use /faceless-explainer), captions on existing footage (use /embedded-captions), or a short unnarrated motion graphic (use /motion-graphics). If the intent is unclear, route through /hyperframes first.

1345AbhishekKumar/starter-supabase

Port an existing Remotion (React) composition to HyperFrames HTML. Use ONLY when the user explicitly asks to port/convert/migrate/translate a Remotion source. Do NOT use: (a) authoring a new HyperFrames composition; (b) Remotion mentioned in passing; (c) Remotion code shared as reference only; (d) "same video as my Remotion one" without explicit migrate request — treat as fresh build. Doubt → `/general-video`. One-way, Remotion-only: no reverse export (HyperFrames→Remotion or any framework), no non-Remotion source (After Effects, Framer Motion, plain React/CSS) → out of scope, re-create via `/general-video`. Flags unsupported patterns (useState, useEffect, async calculateMetadata, third-party React libs, `@remotion/lambda`) and recommends runtime interop over lossy translation. Unsure whether to port vs. build fresh, or only a passing Remotion mention? → /hyperframes.

1345AbhishekKumar/starter-supabase

Capture a general website/URL and turn it into a HyperFrames video (site tour, showcase, or social clip from the site's own visuals). Uses headless Chrome screenshots + brand assets. Use when intent is general — portfolio/blog/landing-page showcase or social clip from the site. NOT for: product/SaaS launch or promo (→ /product-launch-video, even from a URL); topic explainer with no site (→ /faceless-explainer); GitHub PR (→ /pr-to-video); adding captions to existing video (→ /embedded-captions); short unnarrated page-highlight motion graphic (→ /motion-graphics). Unclear launch-vs-general-site? Ask one question or start at /hyperframes.

Skills relacionados