Communitygithub.com

1345AbhishekKumar/starter-supabase

Úsalo cuando el usuario quiera un gráfico animado corto y de diseño, donde el movimiento sea el mensaje: tipografía cinética, conteo de estadísticas, visualización de datos, logotipo, bloque de marca, tercio inferior, llamada, superposición social, titular animado, tweet/noticia, póster animado o resumen rápido de página. Normalmente dura menos de 10 segundos y hasta unos 30 segundos, sin arco narrativo, voz en off o sujeto de acción real. Puede renderizarse a MP4 o superposición transparente. No es para piezas más largas, de varias escenas, narradas o de marca (usa general-video), videos narrados de sitios web (website-to-video), explicadores de temas (faceless-explainer), promociones de productos (product-launch-video), videos de relaciones públicas (pr-to-video) o subtítulos en metraje existente (embedded-captions). Cuando no estés seguro si es una pieza corta basada en movimiento o un tratamiento más largo o narrado, consulta /hyperframes.

¿Qué es starter-supabase?

Este skill de agente de IA para Claude Code, Cursor o Codex está diseñado para crear gráficos animados breves y centrados en el diseño, donde el movimiento es el mensaje principal. Su propósito es generar piezas de menos de 10 segundos (hasta ~30 segundos) que no requieren narración, voz en off ni sujetos de acción real. Es ideal para elementos como tipografía cinética, conteo de estadísticas, visualizaciones de datos, logotipos, tercios inferiores, superposiciones sociales, titulares animados, tweets o noticias, y resúmenes rápidos de páginas capturadas. El skill sigue un flujo de trabajo estructurado en fases (inicio, planificación, búsqueda de activos, diseño, construcción, renderizado y verificación) y se basa en activos reales antes de diseñar el plano. Soporta renderizado a MP4 o formato con superposición transparente (WebM/MOV). Es fundamental diferenciarlo de otros skills como general-video, website-to-video, faceless-explainer, product-launch-video, pr-to-video o embedded-captions, que cubren formatos más largos, narrados o con otras características.

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

Preguntar en tu IA favorita

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

Documentación

motion-graphics — entrada de despacho

Confirma la ruta antes del Paso 0. Este skill crea un gráfico animado corto, de diseño y sin narración (el movimiento es el mensaje; ~menos de 10s, sin voz en off). Un tratamiento más largo, de varias escenas o narrado → /general-video; un video narrado de un sitio web → /website-to-video; un explicador de tema → /faceless-explainer; una promoción de producto → /product-launch-video; subtítulos en metraje existente → /embedded-captions. Fuera del alcance: datos en vivo / en tiempo de renderizado, o metraje que no se pueda capturar. ¿No estás seguro si es de movimiento primero o narrado? Lee /hyperframes primero.

Un gráfico animado corto y de diseño. Activos primero: decide la estrategia de activos y obtén material real antes de diseñar el plano, luego diseña el plano en torno a lo que tienes, y luego compón reutilizando capacidades del catálogo. Todos los artefactos van a PROJECT_DIR = videos/<nombre-del-proyecto>/ (creado en el Paso 0); todas las rutas a continuación son relativas a él.

FaseEjecuciónArtefacto principalFlujo detallado
initBashhyperframes.jsonPaso 0
plansubagente — ¿decidir búsqueda? + clasificar + estrategia de activosshot-plan.json (borrador: categoría, consultas asset_needs, resumen)agents/director.md (Parte 1)
source ◇Bash — resolución de medios (omitir si asset_needs está vacío)assets/ + assets/index.mdphases/source/guide.md
designsubagente — diseño del plano en torno a los activos resueltosshot-plan.json (final: bloque(s) + diseño + movimiento + posiciones)agents/director.md (Parte 2)
buildsubagente — composición que prioriza reutilizacióncompositions/index.htmlagents/builder.md
renderBash — hyperframes render (MP4, o --format webm/mov para superposición)renders/video.mp4Paso 5
verifyBash — lint / inspect -> subagente de reparación en caso de fallo(arreglos en el lugar)agents/finalize.md

◇ source se ejecuta solo cuando la categoría elegida declara activos. Las categorías de solo código/texto (ej. kinetic-type, la mayoría de charts/stat) tienen asset_needs: [] y pasan directamente del plan al diseño.

Categorías — divididas por la decisión de búsqueda

La primera decisión de plan es: ¿esto necesita una búsqueda? Esa bifurcación divide las categorías en dos grupos; luego se elige la categoría específica — para las impulsadas por búsqueda, según el tipo de contenido que devuelve la búsqueda. Cada categoría es un categories/<id>/module.md (sus reglas de planificación y construcción); el vocabulario de movimiento compartido vive en references/motion-vocabulary.md (→ reglas/planos de hyperframes-animation + bloques de registro).

Categorías de formulario — sin búsqueda; el usuario proporciona el contenido:

CategoríaIntenciónSe apoya en
kinetic-typelínea / cita / título impactante, texto con movimientobloques caption-* + reglas de animación
statnúmero héroe único / conteo + anilloapple-money-count / rules/{counting-dynamic-scale, stat-bars-and-fills}
chartsbarras / líneas / circulares / carrera / % desde datosbloque data-chart
logo-reveallogotipo / bloque de marca (logotipo del usuario)logo-outro / rules/svg-path-draw
lower-thirdsbarras de nombre / título, llamadas, superposiciones socialescaption-* + bloques de superposición del registro

Categorías impulsadas por búsqueda — buscar primero, luego animar según el tipo de contenido (la ruta RWA):

Contenido devueltoCategoríaAnimación
página web / enlacewebpageanimación de página web / interfaz de usuario (desplazamiento, revelación, cursor, llamadas)
artículo de noticiasnewsrevelación de titular + tarjeta de fuente + llamadas de datos clave
tweettweettarjeta de tweet animada
imagen / entidadasset-fusionla geometría del activo se convierte en el gráfico (fusión diegética RWA)

Orden de construcción: uno a la vez, priorizando cobertura (lo básico está bien). kinetic-type portado del prototipo; el resto sigue.

Requisitos previos

macOS Apple Silicon o Linux x64. Herramientas del sistema: brew install node ffmpeg. npx hyperframes doctor una vez. Renderizado con GPU en macOS: export PRODUCER_BROWSER_GPU_MODE=hardware.

Claves opcionales (alternativas locales si no están configuradas) — solo las necesitan las categorías que obtienen/generan activos a través de media-use:

ClaveUsada paraAlternativa
GEMINI_API_KEY / GOOGLE_API_KEYgeneración de imágenes (resolución media-use)omitir generar / solo búsqueda
(proveedores de búsqueda de activos)búsqueda de activos reales para webpage/news/tweet + asset-fusionla categoría se degrada a sin activos

Flujo

Paso 0 — Inicializar

El directorio de trabajo actual es la raíz del espacio de trabajo del agente; escribe todos los artefactos bajo PROJECT_DIR = videos/<nombre-del-proyecto>/. <nombre-del-proyecto>: usa el directorio que dio el usuario, si no, un nombre corto en kebab-case a partir de la intención (<tema>-motion). No el nombre base del espacio de trabajo ni una marca de tiempo.

Solo cuando $PROJECT_DIR/hyperframes.json está ausente:

PROJECT_DIR="${MOTION_GRAPHICS_DIR:-videos/<nombre-del-proyecto>}"
mkdir -p "$(dirname "$PROJECT_DIR")"
npx hyperframes init "$PROJECT_DIR" --non-interactive --example=blank

init verifica las habilidades instaladas contra las últimas en GitHub y actualiza el conjunto global si alguna está desactualizada.

Restricciones: nunca ejecutes hyperframes init en la raíz del espacio de trabajo; nunca anides otro hyperframes/ dentro de PROJECT_DIR; cada comando Bash (maestro + subagentes) es un sub-shell (cd "$PROJECT_DIR" && ...) — nunca cd simple.

Paso 1 — Planificar (subagente: Director Parte 1)

Despacha un subagente. prompt = completo agents/director.md + ## Contexto de despacho (SKILL_DIR / PROJECT_DIR / la solicitud del usuario / Esquema: <SKILL_DIR>/references/shot-plan-ir.md). Debe:

  1. Decidir: ¿esto necesita una búsqueda? (la primera bifurcación)
    • No → elegir una categoría de formulario (kinetic-type / stat / charts / logo-reveal / lower-thirds); el contenido lo proporciona el usuario; asset_needs: [].
    • Sí → emitir un plan de búsqueda en asset_needs[] (noticias / web / tweet / imagen; consultas de dos polos). La categoría impulsada por búsqueda específica (webpage / news / tweet / asset-fusion) se confirma por el tipo de contenido devuelto en el Paso 2, y se finaliza en el Paso 3.
  2. Escribir un borrador de shot-plan.json (envoltorio + categoría de formulario elegida o intención de búsqueda + asset_needs + un resumen del plano de un párrafo). Esquema: references/shot-plan-ir.md.

Validación: [ -s "$PROJECT_DIR/shot-plan.json" ] && echo ok || echo missing.

Paso 2 — Obtener ◇ (Bash: media-use, condicional)

Si shot-plan.json.asset_needs no está vacío, resolver activos (buscar / generar / obtener → rutas locales fijas del proyecto + registro). Consulta phases/source/guide.md (envuelve media-use resolve; las categorías impulsadas por búsqueda usan la búsqueda de noticias/web/tweet/imagen). Si asset_needs está vacío, saltar al Paso 3.

# ilustrativo — consulta phases/source/guide.md
(cd "$PROJECT_DIR" && node <SKILL_DIR>/phases/source/resolve.mjs --plan ./shot-plan.json --out ./assets)

Degradar con elegancia: si un proveedor de búsqueda no está disponible, la categoría vuelve a la variante sin activos (anótalo en context.log).

Paso 3 — Diseñar (subagente: Director Parte 2)

Despacha un subagente (prompt = agents/director.md Parte 2 + contexto de despacho que incluya assets/index.md resuelto si se ejecutó el Paso 2 + catalog-map.md). Diseña el plano en torno a los activos disponibles: elige el/los bloque(s) del catálogo + las reglas/planos de hyperframes-animation, el diseño, el movimiento, los tiempos y (para asset-fusion) las element_positions + la paleta de cuentagotas. Finaliza shot-plan.json (content.block + content.customize + contenido por categoría).

Paso 4 — Construir (subagente: Constructor, priorizar reutilización)

Despacha un subagente. prompt = completo agents/builder.md + contexto de despacho (shot-plan.json, catalog-map.md, el module.md de la categoría, references/motion-vocabulary.md, references/builder-contract.md). Priorizar reutilización: npx hyperframes add <block> + personalizar en el lugar; escribir a mano solo las brechas + la funcionalidad de fusión de activos. Salida compositions/index.html que cumple con el contrato HF (línea de tiempo GSAP pausada en window.__timelines, class="clip" + ids estables, tl.seek(0), determinista).

Paso 5 — Renderizar (Bash)

(cd "$PROJECT_DIR" && npx hyperframes render . --skill=motion-graphics -q draft -o ./renders/video.mp4)
# variante de superposición transparente: --format webm  (o mov)

Paso 6 — Verificar (Bash → subagente de reparación en caso de fallo)

(cd "$PROJECT_DIR" && npx hyperframes lint . && npx hyperframes inspect .)

código de salida 0 → hecho. En caso de errores de lint/inspect, despachar el subagente de reparación (agents/finalize.md: QA de instantánea + una pasada de arreglo en el lugar + re-renderizar). Nunca cambiar una duración fija durante la reparación.

Informe + vista previa opcional

Informar la salida final (renders/video.mp4, o la variante de superposición .webm / .mov) + duración. No abrir una vista previa durante la ejecución. Ofrecerla solo a pedido, iniciada después del renderizado para que sirva el archivo final:

(cd "$PROJECT_DIR" && npx hyperframes preview)   # Interfaz de Studio; o `npx hyperframes play` para un enlace compartible

Las banderas viven en el skill hyperframes-cli (references/preview-render.md).

Tabla de reanudación

EstadoContinuar desde
sin shot-plan.jsonPaso 1 (planificar)
shot-plan.json tiene asset_needs, sin assets/Paso 2 (obtener)
shot-plan.json final, sin compositions/index.htmlPaso 3/4 (diseñar+construir)
compositions/index.html existe, sin renders/video.mp4Paso 5 (renderizar) + Paso 6
renders/video.mp4 existeInformar + detener

Notas de diseño (mantenedores — la ejecución no lee esto)

  • Razón de activos primero: la obtención se realiza al principio e informa el diseño del plano (el flujo RWA: analizar → buscar → revisar → componer). Las categorías impulsadas por búsqueda (webpage/news/tweet) y asset-fusion se apoyan en la búsqueda de media-use (noticias/web/tweet/imagen), que es el linaje RWA documentado de media-use.
  • Priorizar reutilización: el análogo dentro del ecosistema de las plantillas generadas por LLM es "componer bloques del catálogo + reglas de hyperframes-animation". La línea de tiempo GSAP pausada de HF equivale a useCurrentFrame de Remotion.
  • Contrato del módulo de categoría: un categories/<id>/module.md (planificación + construcción), que comparte references/motion-vocabulary.md (+ evaluación opcional). Agregar una categoría = soltar la carpeta + registrar su línea de clasificador en agents/director.md + su fila en catalog-map.md; el pipeline de fases no se toca.
  • Estructura del directorio:
    videos/<nombre-del-proyecto>/<
      hyperframes.json  context.log
      shot-plan.json            # el IR (salida del Director)
      assets/  assets/index.md  # salida de media-use (si se obtuvo)
      compositions/index.html   # salida del Constructor
      renders/video.mp4
    
  • Registro: en el enrutador de hyperframes — agregar la intención de "gráfico animado corto de diseño" + descripción del Workflow; tallar los disparadores de motion-graphics fuera de /general-video; agregar bordes inversos de NO-USAR. Consulta motion-graphics-genre.md §5-7.

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

The fallback workflow for authoring custom HyperFrames video compositions at any length or format — longer or multi-scene pieces, brand / sizzle reels, montages, title cards, static loops, and freeform compositions. Input- and length-agnostic. If a specialized workflow clearly fits the input — a marketed product, a website, a topic explainer, a GitHub PR, existing footage, a short motion graphic, or a Remotion port — prefer it (see /hyperframes); use this only as the general fallback when none fit.

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