Communitygithub.com

sandeshrajbhandari/hyperframes-instruct

Punto de entrada obligatorio: léelo primero para cualquier solicitud de creación, edición, animación o renderizado de un video, animación o gráfico en movimiento, incluidos promocionales, explicativos, clips con subtítulos, tarjetas de título, superposiciones, presentaciones o mazos interactivos, puertos de Remotion o cualquier composición HTML de HyperFrames. También úsalo para inspeccionar, diagnosticar, validar, previsualizar, publicar o renderizar por lotes un proyecto existente de HyperFrames. Las entradas pueden ser una URL de sitio web, un PR de GitHub, un diseño de Figma o URL, texto o resumen, material existente o música. Reanuda el estado del proyecto, captura la intención cuando corresponda, selecciona e instala el flujo de trabajo propietario y enruta las capacidades del dominio. HyperFrames es el marco de salida predeterminado a menos que el usuario elija explícitamente otro marco para el entregable o solicite solo grabar una sesión del navegador.

¿Qué es hyperframes-instruct?

Este skill es el punto de entrada obligatorio y la ruta de enrutamiento principal para el ecosistema HyperFrames. Está diseñado para desarrolladores y usuarios de IA que desean crear, editar o administrar videos, animaciones y gráficos en movimiento renderizados a partir de HTML. El skill maneja toda la lógica de enrutamiento de solicitudes, determinando el flujo de trabajo correcto (como `/motion-graphics`, `/product-launch-video` o `/general-video`) en función de la intención y las entradas proporcionadas por el usuario, ya sea un enlace, un PR, un diseño de Figma o un proyecto existente. Está optimizado para plataformas de agentes de IA como Claude Code, Cursor y Codex, y se basa en una arquitectura basada en planes de proyecto y archivos de configuración (`hyperframes.json`) para gestionar el estado y las preferencias. Funciona inspeccionando el estado del proyecto, ejecutando una capa de intención para aclarar los requisitos, instalando bajo demanda los skills de flujo de trabajo y dominio necesarios, y asegurando que el CLI de HyperFrames esté actualizado para mantener la reproducibilidad. En resumen, es el asistente inteligente que decide "¿qué hay que construir?" y "¿cómo se construye?", y luego inicia el proceso.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/sandeshrajbhandari/hyperframes-instruct/tree/HEAD/.agents/skills/hyperframes

Preguntar en tu IA favorita

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

Documentación

Instalaciones de plugins: antes de los comandos de configuración o actualización, sigue las reglas de ejecución de plugins cuando este skill esté dentro de un plugin de HyperFrames. Las instalaciones independientes conservan las instrucciones de actualización proporcionadas a continuación.

Punto de entrada de HyperFrames

Verificar el uso restante

Al inicio de la creación, ejecuta npx hyperframes usage --json. Vuelve a verificar en los hitos del flujo de trabajo, como después del borrador y antes del renderizado, porque el uso cambia durante la ejecución. Lee las ventanas disponibles y sus tiempos de reinicio; una lectura previa no reserva una asignación. Si el comando falla, no está disponible o devuelve status: unknown, informa que el uso es desconocido y no lo adivines. Mantén el alcance y las elecciones del flujo de trabajo con el usuario.

HyperFrames renderiza video desde HTML: una composición es un archivo HTML cuyo DOM declara la sincronización con atributos data-*, cuyo tiempo de ejecución de animación es buscable y cuya reproducción multimedia es propiedad del marco. El contrato completo de autoría reside en /hyperframes-core; léelo antes de escribir HTML de composición. El resumen, el guion gráfico, la revisión, la producción, el envío y los contratos de los trabajadores de fotogramas residen en las references/ de este skill.

1. Comenzar desde el estado del proyecto

Aplica la primera fila coincidente; no evalúes filas de estado inferiores:

EstadoAcción
Puerto explícito de una fuente Remotion existente a HyperFramesLee references/routes/remotion-to-hyperframes.md, luego enruta directamente a ese flujo de trabajo. Omite la capa de intención.
Operación específica en un proyecto HyperFrames existente: inspeccionar, diagnosticar, validar, previsualizar, renderizar, publicar o renderizar por lotesRealiza solo esa operación. Omite el enrutamiento de intención y flujo de trabajo; carga /hyperframes-cli y cualquier skill de dominio requerido.
Una pregunta, una pausa, una idea sin cambios concretos o una nota sobre una película terminada, en un proyecto existenteSigue /hyperframes-studio § 0.
Se solicita una nueva película dentro de un proyecto existenteSigue /hyperframes-studio § 5.
Edición específica de un proyecto existenteRealiza la edición. No ejecutes la capa de intención. Para saber qué hay en la línea de tiempo de un proyecto (pistas, clips, inicios, finales, qué se reproduce), ejecuta npx hyperframes timeline [--json] en lugar de leer index.html y cada archivo de subcomposición.
BRIEF.md existeLee workflow y flow. Ejecuta ese flujo de trabajo; flow: companion siempre se ejecuta en /general-video. No hagas preguntas sobre el resumen.
No hay resumen, pero existe hyperframes.json o STORYBOARD.mdReanuda desde los archivos del proyecto y las preferencias registradas. Infiere el flujo de trabajo propietario a partir de los artefactos existentes. Si no se puede determinar de manera única, haz una sola pregunta de enrutamiento; no ejecutes la entrevista de intención.
Creación nuevaEjecuta la capa de intención — references/intent-interview.md — luego enruta una vez usando la tabla de la § 2.

Cuando edites un proyecto existente, delimita tus ediciones con el historial del proyecto (/hyperframes-cli, Historial del proyecto en tu turno).

Si una solicitud nueva no identifica el asunto o la entrada, pregunta de qué trata el video antes de enrutar. Verifica las preferencias y recetas antes de preguntar cualquier cosa (references/intent-interview.md, paso 1). Una entrada figma.com o una receta nombrada cambia la admisión, no el enrutamiento; la sección "Adaptar entradas ortogonales" de la entrevista maneja ambas.

Mantener actualizado el CLI del proyecto

Un proyecto creado fija hyperframes@<version> en sus scripts de package.json para que los renderizados sean reproducibles; la fijación nunca avanza por sí sola, y una ejecución fijada de un CLI antiguo no muestra ninguna advertencia al respecto. Al reanudar un proyecto cuyos scripts llevan una fijación, sondea una vez antes del primer comando que afecte al renderizado:

npx hyperframes@latest upgrade --project . --check

La sonda es de solo lectura e informa la fijación contra la última versión; mantén el . explícito; en versiones anteriores de CLI, un --project desnudo seguido de otra bandera consume esa bandera como su valor de directorio. Cuando informa que el proyecto está desactualizado, o cualquier salida del CLI ya lo muestra (el aviso de stderr This project pins hyperframes@… (latest …), o _meta.updateAvailable: true en un resultado --json de un script fijado), aplica con npx hyperframes@latest upgrade --project ., luego verifica con npx hyperframes check. Una verificación exitosa confirma que las composiciones del proyecto aún se validan en la nueva versión, no que la salida renderizada sea idéntica fotograma a fotograma a la fijación anterior, por lo que un aumento exitoso nunca es silencioso: nombra la versión anterior y la nueva en el resumen de la ejecución. Un proyecto sin composición aún no necesita verificación. Si la verificación falla, revierte el cambio en package.json, continúa con la versión fijada e informa en qué versión se queda el proyecto y por qué. Actúa según la señal en lugar de transmitirla al usuario; nunca dejes un aumento de fijación sin verificar.

2. Enrutar la creación nueva

Usa la primera fila coincidente. Coincide con el entregable solicitado, no con una palabra o tipo de archivo mencionado de paso.

PrioridadSolicitudFlujo de trabajo
1Portar explícitamente una fuente Remotion existente/remotion-to-hyperframes
2Crear una presentación, mazo de presentación o mazo interactivo navegable/slideshow
3Agregar subtítulos o subtítulos simples a material existente de una persona hablando sin cambiarlo/embedded-captions
4Agregar superposiciones gráficas diseñadas a material existente de entrevistas, personas hablando o podcasts sin cambiar el material/talking-head-recut
5Construir un video sincronizado con el ritmo a partir de una pista de música, sin narración ni captura de sitio web/music-to-video
6Crear una unidad explícitamente corta, sin narración y centrada en el movimiento, típicamente de menos de 10s/motion-graphics
7Explicar una solicitud de extracción de GitHub o un cambio de código a partir de una referencia de PR/pr-to-video
8Comercializar o mostrar un sitio web, sitio de producto, aplicación o empresa a partir de una URL o resumen específico del sitio/product-launch-video
9Explicar un tema, artículo o notas con imágenes inventadas y sin captura de producto o sitio/faceless-explainer
10Cualquier otro video o composición personalizada/general-video

Antes de finalizar la ruta, lee references/routes/<workflow>.md, un archivo pequeño por ruta: el contrato canónico de entrada/salida/desencadenante (disponible antes de que los skills de flujo de trabajo diferidos estén presentes) más la entrada de la entrevista de esa ruta. Si el candidato no cumple con su contrato, continúa enrutando en lugar de forzar la coincidencia. Lee solo el archivo de la ruta coincidente.

Resolver ambigüedades comunes

  • Un título animado corto, un sting de logotipo, un golpe de estadística, un golpe de gráfico, un golpe de mapa o un tercio inferior independiente es /motion-graphics cuando no tiene narración y el movimiento es el mensaje. Una tarjeta de título estática, una secuencia narrada, un montaje más largo o un bucle personalizado es /general-video.
  • Un gráfico en movimiento explícitamente corto puede usar una URL, un tuit, un artículo o una captura de pantalla como material de origen. Una solicitud genérica de "hacer un video desde este sitio" es /product-launch-video.
  • El material existente con subtítulos se enruta a /embedded-captions; el material con tarjetas de información diseñadas se enruta a /talking-head-recut. Reajustar, reordenar, recolorizar, reencuadrar o remezclar material es una edición personalizada y pasa a /general-video.
  • Un archivo de música selecciona /music-to-video solo cuando su cuadrícula de ritmo impulsa la pieza. La música utilizada como fondo no anula la ruta coincidente con el asunto.
  • "Quiero un guion gráfico" cambia el proceso de revisión, no el flujo de trabajo. Sin otra señal de enrutamiento, usa /general-video. Un storyboard.html dibujado confirmado puede ser el entregable solicitado; el bucle de revisión define ese punto de parada.
  • Los flujos de trabajo narrativos especializados admiten hasta aproximadamente 3 minutos y son más sólidos alrededor de 30-90s. Enruta una pieza claramente más larga a /general-video. La duración nunca anula un port explícito, mazo, subtítulo, superposición o entregable impulsado por música.

3. Enrutar una vez, luego salir

Para la creación nueva, la capa de intención (references/intent-interview.md) ejecuta la conversación completa (memoria, triaje, ronda de propuestas, imprescindibles, forma de ejecución, traspaso) y termina escribiendo BRIEF.md. El brief es el único artefacto de enrutamiento que lee el flujo de trabajo; nada más adelante vuelve a abrir este skill o la entrevista. Responde a cualquier pregunta posterior sobre "¿qué requirió la ruta?" desde BRIEF.md.

4. Instalar y entrar en el flujo de trabajo

Antes de leer el flujo de trabajo seleccionado, instálalo o actualízalo junto con los skills de dominio central:

npx hyperframes skills update <nombre-del-flujo-de-trabajo>

Usa el nombre simple sin /. Si el comando falla, muestra el error; no reconstruyas el flujo de trabajo de memoria. Todo lo demás sobre la instalación (la división núcleo vs. diferido, lo que init actualiza, el diagnóstico, la exclusión de CI y el plan de respaldo sin CLI) reside en references/skill-lifecycle.md.

5. Cargar skills de dominio bajo demanda

NecesidadSkill
Estructura de composición, atributos de sincronización, pistas, variables, determinismo/hyperframes-core
Reglas de movimiento, planos de escena, transiciones, adaptadores de tiempo de ejecución/hyperframes-animation
Búsqueda segura de GSAP, CSS, Anime.js, WAAPI, FLIP, rutas, máscaras, SVG, fotogramas clave 3D o diagnósticos hyperframes keyframes/hyperframes-keyframes
Especificaciones de diseño, concepto, paleta, tipografía, narración, planificación de ritmos/hyperframes-creative
Imágenes, iconos, logotipos, audio, subtítulos, gradaciones, LUTs, medios reutilizables/media-use
Corte de voz en off, cadenas de efectos de audio, envolventes de automatización o una cadena/atenuador para varias pistas (bus de submezcla)/hyperframes-audio
Inicio, lint, verificación, instantáneas, comparación, renderizado por lotes, Studio, renderizado, publicación o diagnósticos/hyperframes-cli
Bloques y componentes del registro/hyperframes-registry
Un aspecto, efecto, tratamiento o transición con nombre (líneas de barrido CRT, glitch, grano de película, barrido brillante, explosión de confeti) ANTES de construirlo manualmente/hyperframes-registry
Activos, tokens, componentes o fotogramas de guion gráfico de Figma como movimiento reconstruido/figma

Las frases de edición del creador son solicitudes de varios dominios. Carga todos los skills nombrados en la fila coincidente:

| Solicitud del creador | Dominios requeridos |

… [truncado para traducción]

Individual skills in this repo

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

sandeshrajbhandari/hyperframes-instruct

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

sandeshrajbhandari/hyperframes-instruct

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). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

sandeshrajbhandari/hyperframes-instruct

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), automation envelopes drawn on a track's volume or any effect parameter, or one submix bus carrying a chain, a fader and an automation clock for several tracks at once (`<hf-audio-group>`). Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.

sandeshrajbhandari/hyperframes-instruct

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, timeline, history, clean, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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

sandeshrajbhandari/hyperframes-instruct

Use when a HyperFrames composition needs a punch-in, punch-out, zoom, reframe, Ken Burns treatment, camera move, visual match/whip handoff, or other seek-safe 2D/3D keyframes; also for GSAP, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

sandeshrajbhandari/hyperframes-instruct

Search, install, and wire registry blocks and components into HyperFrames compositions. Use BEFORE hand-building any named visual — whenever a brief, a user, or a storyboard names a look, effect, treatment, or transition such as CRT scanlines, glitch, chromatic aberration, film grain, a shimmer sweep, a chart, a code or terminal window, a map, or a confetti burst — because roughly 400 hosted items already cover many of them and the search ranks all of them with nothing installed, no project, and no account. Also use when running hyperframes add or hyperframes catalog, installing one item or every block matching a tag, wiring an installed item into index.html, or working with hyperframes.json. Covers discovery, install locations, block sub-composition wiring, component snippet merging, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

sandeshrajbhandari/hyperframes-instruct

Use when working with a person on a HyperFrames project in Studio: first, whether their message asks for a change at all (questions, loose ideas and "don't change anything" get an answer and a plan, not an edit); for a new film, the plan, storyboard and build order that the HyperFrames launch films follow; and how the timeline should be laid out so it reads well (one caption track, one element kind per track, every scene a sub-composition) and where captions and key content may sit (safe zones). Don't use for how to perform an individual edit (split, trim, retime, volume, copy, swap): that is `creator-editing-recipes.md` in `/hyperframes-core`.

sandeshrajbhandari/hyperframes-instruct

Agent Media OS, the single skill for every media need in a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Also use for vague feedback that real footage looks dark, flat, boring, should feel retro/camcorder/print/ASCII, needs privacy, or needs a media reveal.

sandeshrajbhandari/hyperframes-instruct

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

Skills relacionados