Communitygithub.com

1345AbhishekKumar/starter-nextjs

Úsalo cuando el usuario solicite un motion graphic corto y guiado por diseño donde el movimiento sea el mensaje: tipografía cinética, conteo de estadísticas, gráficos animados, logotipos, cintillos, superposiciones sociales, titulares animados, pósters en movimiento o resúmenes de página capturada. Normalmente dura menos de 10 segundos y hasta ~30 segundos, sin voz en off ni sujeto real. Puede renderizarse en MP4 o superposición transparente. No es apto para piezas más largas, con varias escenas, narradas o de reel de marca (usar 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 sobre material existente (embedded-captions). Si no está seguro de si es una pieza rápida centrada en movimiento o un tratamiento más largo o narrado, consulta /hyperframes.

¿Qué es starter-nextjs?

Este skill está diseñado para crear motion graphics cortos y visualmente impactantes, donde el movimiento y el diseño son los protagonistas, sin narración ni voz en off. Está pensado para piezas de menos de 10 segundos (hasta unos 30 segundos) como tipografía cinética, conteo de estadísticas, gráficos animados, logotipos animados, cintillos, superposiciones para redes sociales, titulares animados o pósters en movimiento. El skill sigue un flujo de trabajo estructurado en fases: inicialización del proyecto, planificación (decidiendo si se necesita búsqueda de activos), obtención de activos (si es necesario), diseño del plano, construcción con bloques reutilizables, renderizado a video (MP4 o superposición transparente) y verificación con lint e inspección. Se integra con la herramienta hyperframes y requiere macOS Apple Silicon o Linux x64, Node.js y ffmpeg. Es importante destacar que no es adecuado para piezas más largas, narradas o con varias escenas; para esos casos se deben usar otros skills especializados como general-video, website-to-video, faceless-explainer, product-launch-video, pr-to-video o embedded-captions.

Compatible con~Claude Code~Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/1345AbhishekKumar/starter-nextjs/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 dispatch

Confirma la ruta antes del Paso 0. Este skill crea un motion graphic corto, guiado por diseño y sin narración (el movimiento es el mensaje; ~menos de 10 segundos, sin voz en off). Un tratamiento más largo, con 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 sobre material existente → /embedded-captions. Fuera de alcance: datos en vivo o en tiempo de renderizado, o material que no se pueda capturar. ¿No estás seguro si es movimiento primero o narrado? Lee /hyperframes primero.

Un motion graphic corto guiado por diseño. Primero los activos: 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 después 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 uso 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 con reutilización primerocompositions/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(correcciones in situ)agents/finalize.md

◇ source se ejecuta solo cuando la categoría elegida declara activos. Las categorías de solo código/texto (por ejemplo, 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 titular impactante texto con movimiento primerobloques caption-* + reglas de animación
statnúmero heroico único / conteo + anilloapple-money-count / rules/{counting-dynamic-scale, stat-bars-and-fills}
chartsgráfico de barras / líneas / circular / carrera / % a partir de datosbloque data-chart
logo-revealsting de logotipo / bloqueo 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 / UI (desplazamiento, revelación, cursor, llamadas)
artículo de noticiasnewsrevelación de titular + tarjeta de fuente + llamadas a 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 (un borrador es suficiente). kinetic-type se migró del prototipo; el resto sigue.

Requisitos previos

macOS Apple Silicon o Linux x64. Herramientas del sistema: brew install node ffmpeg. Ejecuta 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 mediante media-use:

ClaveSe usa paraAlternativa
GEMINI_API_KEY / GOOGLE_API_KEYgeneración de imágenes (resolución media-use)omitir generación / solo búsqueda
(proveedores de búsqueda asset_scout)búsqueda de activos reales de 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 área de trabajo del agente; escribe todos los artefactos bajo PROJECT_DIR = videos/<nombre-del-proyecto>/. <nombre-del-proyecto>: usa el directorio que el usuario proporcionó, o un nombre corto en kebab-case a partir de la intención (<asunto>-motion). No uses el nombre base del área 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 los skills instalados contra los más recientes en GitHub y actualiza el conjunto global si alguno está desactualizado.

Restricciones: nunca ejecutes hyperframes init en la raíz del área de trabajo; nunca anides otro hyperframes/ dentro de PROJECT_DIR; cada comando Bash (maestro + subagentes) es un subshell (cd "$PROJECT_DIR" && ...) — nunca uses cd sin paréntesis.

Paso 1 — Planificar (subagente: Director Parte 1)

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

  1. Decidir: ¿esto necesita una búsqueda? (la primera bifurcación)
    • No → elige una categoría de formulario (kinetic-type / stat / charts / logo-reveal / lower-thirds); el contenido lo proporciona el usuario; asset_needs: [].
    • Sí → emite 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 según el tipo de contenido devuelto en el Paso 2 y se finaliza en el Paso 3.
  2. Escribir un borrador de shot-plan.json (envoltura + categoría de formulario elegida o intención de búsqueda + asset_needs + un resumen de 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, resuelve activos (buscar / generar / obtener → rutas locales congeladas 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, salta 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)

Degrada con elegancia: si un proveedor de búsqueda no está disponible, la categoría retrocede a 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 dispatch incluyendo el assets/index.md resuelto si el Paso 2 se ejecutó + 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 beats y (para asset-fusion) las element_positions + paleta de cuentagotas. Finaliza shot-plan.json (content.block + content.customize + contenido por categoría).

Paso 4 — Construir (subagente: Builder, reutilización primero)

Despacha un subagente. prompt = agents/builder.md completo + contexto de dispatch (shot-plan.json, catalog-map.md, el module.md de la categoría, references/motion-vocabulary.md, references/builder-contract.md). Reutilización primero: npx hyperframes add <block> + personalizar in situ; solo escribe a mano los vacíos y la capacidad de fusión de activos. Genera compositions/index.html cumpliendo 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 .)

Salida 0 → terminado. Si hay errores de lint/inspect, despacha el subagente de reparación (agents/finalize.md: instantánea de QA + una pasada de corrección in situ + rerenderizado). Nunca cambies una duración fija durante la reparación.

Informe + vista previa opcional

Informa el resultado final (renders/video.mp4, o la variante de superposición .webm / .mov) + duración. No abras una vista previa durante la ejecución. Ofrece una solo si se solicita, 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)

  • Fundamento de priorizar activos: la obtención se carga 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 la línea documentada de RWA de media-use.
  • Reutilización primero: 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 es similar 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 = crear la carpeta + registrar su línea clasificadora en agents/director.md + su fila en catalog-map.md; la tubería de fases no se modifica.
  • 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 Builder
      renders/video.mp4
    
  • Registro: en el enrutador de hyperframes — añadir la intención "motion graphic corto guiado por diseño" + descripción del Workflow; separar los disparadores de motion-graphics de /general-video; añadir 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-nextjs

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

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

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

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

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

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

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

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

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

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

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

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

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