Communitygithub.com

Army161/OpenMontage

Se usa cuando el usuario desea un motion graphic corto y centrado en el diseño, donde el movimiento es el mensaje: tipografía cinética, conteo de estadísticas o números, impacto de gráficos/visualización de datos, animación de logotipo, bloque de marca, tercio inferior, llamada, superposición social, titular/tweet/noticia animada, póster en movimiento o resumen rápido de página capturada. Generalmente de menos de 10 segundos y hasta ~30 segundos, sin arco narrativo, locución ni 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 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) ni subtítulos en material existente (embedded-captions). Cuando no esté seguro si es una pieza corta centrada en el movimiento o un tratamiento más largo/narrado, consulte /hyperframes.

¿Qué es OpenMontage?

Army161/OpenMontage es una skill de agente de IA diseñada para crear motion graphics cortos y centrados en el diseño, donde el movimiento mismo es el mensaje principal. La skill está optimizada para piezas de menos de 10 segundos (hasta ~30 segundos) sin locución, arco narrativo ni sujeto de acción real. Soporta una amplia gama de formatos como tipografía cinética, conteo de estadísticas, animación de logotipos, tercios inferiores, superposiciones para redes sociales, tuits animados y más. La skill sigue un flujo de trabajo estructurado en fases: inicialización, planificación (con decisión de búsqueda), obtención de activos (condicional), diseño, construcción, renderizado y verificación. Utiliza el ecosistema Hyperframes para la composición y renderizado, y puede generar salida en MP4 o formatos de superposición transparente (WebM/MOV). La skill distingue entre categorías 'formales' (sin búsqueda, contenido proporcionado por el usuario) y categorías 'impulsadas por búsqueda' (que buscan y animan contenido de la web, noticias, tweets o imágenes). Es importante destacar que no es adecuada para videos más largos, narrados o de múltiples escenas, y redirige a otras skills especializadas cuando corresponde.

Compatible con~Claude Code~Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/Army161/OpenMontage/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

Confirme la ruta antes del Paso 0. Esta skill crea un motion graphic corto, centrado en el diseño y sin narración (el movimiento es el mensaje; ~menos de 10 s, sin locución). 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 temas → /faceless-explainer; una promoción de producto → /product-launch-video; subtítulos en material existente → /embedded-captions. Fuera del alcance: datos en vivo / al momento del renderizado, o material que no se pueda capturar. ¿No está seguro si es centrado en movimiento o narrado? Lea /hyperframes primero.

Un motion graphic corto centrado en el diseño. Primero los activos: decida la estrategia de activos y obtenga material real antes de diseñar la toma, luego diseñe la toma en torno a lo que tiene y, finalmente, componga reutilizando las 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 este.

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)
fuente ◇Bash — resolución de uso multimedia (omitir si asset_needs está vacío)assets/ + assets/index.mdphases/source/guide.md
diseñosubagente — diseño de toma en torno a activos resueltosshot-plan.json (final: bloque(s) + diseño + movimiento + posiciones)agents/director.md (Parte 2)
construirsubagente — composición priorizando reutilizacióncompositions/index.htmlagents/builder.md
renderizarBash — hyperframes render (MP4, o --format webm/mov para superposición)renders/video.mp4Paso 5
verificarBash — lint / inspect -> subagente de reparación en caso de fallo(correcciones en el lugar)agents/finalize.md

◇ fuente se ejecuta solo cuando la categoría elegida declara activos. Las categorías puramente de código/texto (p. ej., kinetic-type, la mayoría de charts/stat) tienen asset_needs: [] y saltan directamente de planificación a diseño.

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

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

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

CategoríaIntenciónSe apoya en
kinetic-typelínea / cita / título impactante, texto centrado en movimientobloques caption-* + reglas de animación
statnúmero / conteo heroico único + 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-revealanimación de logotipo / 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 / IU (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. Ejecutar 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 uso multimedia:

ClaveSe usa paraAlternativa
GEMINI_API_KEY / GOOGLE_API_KEYgeneración de imágenes (resolución de uso multimedia)omitir generación / solo búsqueda
(proveedores de asset_scout / búsqueda)búsqueda de activos reales 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; escriba todos los artefactos bajo PROJECT_DIR = videos/<nombre-del-proyecto>/. <nombre-del-proyecto>: use el directorio que dio el usuario, si no, un nombre corto en kebab-case derivado de la intención (<asunto>-motion). No use 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 skills instaladas con las últimas en GitHub y actualiza el conjunto global si alguna está desactualizada.

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

Paso 1 — Planificar (subagente: Director Parte 1)

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

  1. Decidir: ¿necesita esto una búsqueda? (el primer bifurcador)
    • No → elegir una categoría formal (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 (envoltura + categoría formal elegida o intención de búsqueda + asset_needs + un resumen de toma de un párrafo). Esquema: references/shot-plan-ir.md.

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

Paso 2 — Fuente ◇ (Bash: uso multimedia, condicional)

Si shot-plan.json.asset_needs no está vacío, resolver activos (búsqueda / generación / obtención → rutas locales de proyecto congeladas + registro). Consulte 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 — consulte 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 una sin activos (anótelo en context.log).

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

Despache un subagente (prompt = agents/director.md Parte 2 + contexto de despacho incluyendo el assets/index.md resuelto si se ejecutó el Paso 2 + catalog-map.md). Diseña la toma en torno a los activos disponibles: elija 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 del cuentagotas. Finaliza shot-plan.json (content.block + content.customize + contenido por categoría).

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

Despache un subagente. prompt = agents/builder.md completo + contexto de despacho (shot-plan.json, catalog-map.md, 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 los huecos + la capacidad de fusión de activos. Salida: compositions/index.html respetando 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 → listo. En caso de errores de lint/inspect, despache el subagente de reparación (agents/finalize.md: instantánea de QA + una pasada de corrección en el lugar + re-renderizado). 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 solicitud, iniciada después del renderizado para que sirva el archivo final:

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

Las banderas están en la 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 (fuente)
shot-plan.json final, sin compositions/index.htmlPasos 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 ser de 'primero los activos': la obtención de activos se realiza al principio e informa el diseño de la toma (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 uso multimedia (noticias/web/tweet/imagen), que es el linaje RWA documentado de media-use.
  • Prioridad de 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 es equivalente a useCurrentFrame de Remotion.
  • Contrato del módulo de categoría: un categories/<id>/module.md (planificación + construcción), compartiendo 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 modifica.
  • Estructura de directorios:
    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 "motion graphic corto centrado en el diseño" + descripción del flujo de trabajo; separar los disparadores de motion-graphics de /general-video; agregar bordes inversos de NO-UTILIZAR. Consulte motion-graphics-genre.md §5-7.

Individual skills in this repo

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

Army161/OpenMontage

Generate AI videos from text prompts using multiple provider gateways. Use when: (1) Generating videos from text descriptions, (2) Creating AI-generated video clips for content production, (3) Image-to-video generation with a reference image, (4) Choosing between video generation providers (VEO, Kling, Sora, Runway, Seedance, MiniMax). Supports two gateways: HeyGen API and fal.ai API.

Army161/OpenMontage

Create AI avatar videos with precise control over avatars, voices, scripts, scenes, and backgrounds using HeyGen's v2 API. Use when: (1) Choosing a specific avatar and voice for a video, (2) Writing exact scripts for an avatar to speak, (3) Building multi-scene videos with different backgrounds per scene, (4) Creating transparent WebM videos for compositing, (5) Using talking photos as video presenters, (6) Integrating HeyGen avatars with Remotion, (7) Batch video generation with exact specs, (8) Brand-consistent production videos with precise control.

Army161/OpenMontage

Use p5.js/canvas for local procedural character effects: particles, weather, squash/stretch, walk cycles, and environmental motion.

Army161/OpenMontage

Review local character animation with schema checks, Playwright browser previews, frame sampling, and FFmpeg/ffprobe final output checks.

Army161/OpenMontage

Create videos from a text prompt using HeyGen's Video Agent. Use when: (1) Creating a video from a description or idea, (2) Generating explainer, demo, or marketing videos from a prompt, (3) Making a video without specifying exact avatars, voices, or scenes, (4) Quick video prototyping or drafts, (5) One-shot prompt-to-video generation, (6) User says "make me a video" or "create a video about X".

Army161/OpenMontage

Generate Mandarin and multilingual narration with Volcengine Doubao Speech 2.0. Use when creating Chinese voiceovers, when the user prefers Doubao/Volcengine/火山引擎/豆包 TTS, or when narration needs character-level timestamp metadata for subtitles.

Army161/OpenMontage

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Army161/OpenMontage

Use when implementing Disney's 12 animation principles with Framer Motion in React applications

Army161/OpenMontage

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.

Army161/OpenMontage

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

Army161/OpenMontage

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.

Army161/OpenMontage

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

Army161/OpenMontage

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.

Army161/OpenMontage

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

Army161/OpenMontage

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.

Army161/OpenMontage

Best practices for Remotion - Video creation in React

Army161/OpenMontage

Toolkit-specific Remotion patterns — custom transitions, shared components, and project conventions. For core Remotion framework knowledge (hooks, animations, rendering, etc.), see the `remotion-official` skill.

Army161/OpenMontage

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.

Army161/OpenMontage

Animate SVG character rigs with GSAP, CSS transforms, Remotion frame control, and HyperFrames-compatible browser previews.

Army161/OpenMontage

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

Skills relacionados