Communitygithub.com

nateherkai/hyperframes-student-kit

Instala y conecta bloques y componentes del registro en composiciones HyperFrames. Útil al ejecutar 'hyperframes add', instalar un bloque o componente, conectar un elemento instalado en index.html, o trabajar con hyperframes.json. Cubre el comando add, ubicaciones de instalación, conexión de subcomposiciones de bloques, fusión de fragmentos de componentes y descubrimiento del registro.

¿Qué es hyperframes-student-kit?

Este skill permite a un agente de IA (como Claude Code, Cursor o Codex) gestionar el registro de HyperFrames, que proporciona bloques y componentes reutilizables instalables mediante el comando `hyperframes add <nombre>`. Los bloques son subcomposiciones independientes con sus propias dimensiones, duración y línea de tiempo, que se incluyen mediante `data-composition-src` en una composición anfitriona. Los componentes son fragmentos de efectos sin dimensiones propias, que se pegan directamente en el HTML de una composición anfitriona. El skill cubre el proceso completo: instalación con opciones como `--dir`, `--json` y `--no-clipboard`, ubicaciones de instalación configurables en `hyperframes.json`, conexión de bloques con atributos como `data-composition-id`, `data-start` y `data-track-index`, y fusión de componentes copiando su HTML, CSS y JS. También incluye descubrimiento de elementos disponibles mediante el manifiesto del registro. Es útil para desarrolladores que crean presentaciones multimedia con HyperFrames y necesitan asistencia automatizada para agregar y configurar elementos reutilizables.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nateherkai/hyperframes-student-kit/tree/HEAD/.agents/skills/hyperframes-registry

Preguntar en tu IA favorita

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

Documentación

Registro de HyperFrames

El registro proporciona bloques y componentes reutilizables instalables mediante hyperframes add <name>.

  • Bloques — subcomposiciones independientes (dimensiones, duración, línea de tiempo propias). Se incluyen mediante data-composition-src en una composición anfitriona.
  • Componentes — fragmentos de efectos (sin dimensiones propias). Se pegan directamente en el HTML de una composición anfitriona.

Cuándo usar este skill

  • El usuario menciona hyperframes add, "bloque", "componente" o hyperframes.json
  • Aparece la salida de hyperframes add en la sesión (rutas de archivos, fragmento en el portapapeles)
  • Necesitas conectar un elemento instalado a una composición existente
  • Quieres descubrir qué hay disponible en el registro

Referencia rápida

hyperframes add data-chart              # instalar un bloque
hyperframes add grain-overlay           # instalar un componente
hyperframes add shimmer-sweep --dir .   # apuntar a un proyecto específico
hyperframes add data-chart --json       # salida legible por máquina
hyperframes add data-chart --no-clipboard  # omitir portapapeles (CI/headless)

Después de la instalación, la CLI imprime qué archivos se escribieron y un fragmento para pegar en tu composición anfitriona. El fragmento es un punto de partida: deberás agregar los atributos data-composition-id (debe coincidir con el ID interno de la composición del bloque), data-start y data-track-index al conectar bloques.

Nota: hyperframes add solo funciona para bloques y componentes. Para ejemplos, usa hyperframes init <dir> --example <name>.

Ubicaciones de instalación

Los bloques se instalan en compositions/<name>.html por defecto. Los componentes se instalan en compositions/components/<name>.html por defecto.

Estas rutas son configurables en hyperframes.json:

{
  "registry": "https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry",
  "paths": {
    "blocks": "compositions",
    "components": "compositions/components",
    "assets": "assets"
  }
}

Consulta install-locations.md para obtener todos los detalles.

Conexión de bloques

Los bloques son composiciones independientes: inclúyelos mediante data-composition-src en tu index.html anfitrión:

<div
  data-composition-id="data-chart"
  data-composition-src="compositions/data-chart.html"
  data-start="2"
  data-duration="15"
  data-track-index="1"
  data-width="1920"
  data-height="1080"
></div>

Atributos clave:

  • data-composition-src — ruta al archivo HTML del bloque
  • data-composition-id — debe coincidir con el ID interno del bloque
  • data-start — cuándo aparece el bloque en la línea de tiempo anfitriona (segundos)
  • data-duration — duración de reproducción del bloque
  • data-width / data-height — dimensiones del lienzo del bloque
  • data-track-index — orden de capas (mayor valor = al frente)

Consulta wiring-blocks.md para obtener todos los detalles.

Conexión de componentes

Los componentes son fragmentos: pega su HTML en el marcado de tu composición, su CSS en tu bloque de estilos y su JS en tu script (si lo hay):

  1. Lee el archivo instalado (ej., compositions/components/grain-overlay.html)
  2. Copia los elementos HTML dentro del <div data-composition-id="..."> de tu composición
  3. Copia el bloque <style> en los estilos de tu composición
  4. Copia cualquier contenido <script> en el script de tu composición (antes del código de la línea de tiempo)
  5. Si el componente expone integración con GSAP (consulta el bloque de comentarios en el fragmento), agrega esas llamadas a tu línea de tiempo

Consulta wiring-components.md para obtener todos los detalles.

Descubrimiento

Explora los elementos disponibles:

# Leer el manifiesto del registro
curl -s https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry/registry.json

El registry-item.json de cada elemento contiene: nombre, tipo, título, descripción, etiquetas, dimensiones (solo bloques), duración (solo bloques) y lista de archivos.

Consulta discovery.md para obtener detalles sobre filtrado por tipo y etiquetas.

Individual skills in this repo

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

nateherkai/hyperframes-student-kit

Agent 2 of the video editing pipeline. Finds and removes spoken mistakes — stutters, repeated words, false starts, and retakes (re-recorded lines) — from a talking-head recording. Use after cut-silences, when asked to cut mistakes, remove stutters / repeats / filler restarts, clean up flubs, or keep the best take. Works review-gated: it proposes every cut with context and a reason for approval, then renders only the approved cuts via ffmpeg. Requires a word-level transcript.

nateherkai/hyperframes-student-kit

Agent 1 of the video editing pipeline. Removes silences and dead air from a talking-head recording. Use when asked to cut silences, trim pauses, remove dead air / gaps, or tighten the pacing of a raw video, given a word-level transcript. Produces an edit list (EDL), a re-timed transcript for downstream agents, and optionally the cut video via ffmpeg. Does NOT cut mistakes, repeats, or false starts — that is the cut-mistakes agent.

nateherkai/hyperframes-student-kit

Edit a raw talking-head video through transcription, silence trimming, mistake review, visual storytelling, motion graphics, and verified HyperFrames rendering. Use for a complete edit; route a single requested operation directly to its specialist skill.

nateherkai/hyperframes-student-kit

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

nateherkai/hyperframes-student-kit

HyperFrames CLI tool — hyperframes init, lint, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Use when scaffolding a project, linting or validating compositions, previewing in the studio, rendering to video, transcribing audio, generating TTS, or troubleshooting the HyperFrames environment.

nateherkai/hyperframes-student-kit

Plan, write, time, style, and validate motion-graphic beats for long-form talking-head HyperFrames videos. Use when Codex is asked to add or improve visual beats, glassmorphism lower thirds, crumpled-paper full-screen takeovers, transcript-synced callouts, pacing coverage, YouTube retention graphics, or render-ready overlays in an existing HyperFrames video project.

nateherkai/motion-showreel

Build 10–30s motion-design showreels in the style of Nate's Opus 5.5 CLAUDE/MOTION REEL — brand motif chapters, HUD, BPM-locked cuts, logo lockup.

nateherkai/website-to-hyperframes

Capture a website URL and produce a HyperFrames promo/product-tour video — site → finished marketing video outcome.

Skills relacionados