Communitygithub.com

nateherkai/hyperframes-student-kit

Instalar e conectar blocos e componentes do registro em composições HyperFrames. Use ao executar `hyperframes add`, instalar um bloco ou componente, conectar um item instalado em index.html, ou trabalhar com hyperframes.json. Abrange o comando add, locais de instalação, conexão de sub-composição de blocos, mesclagem de snippets de componentes e descoberta do registro.

O que é hyperframes-student-kit?

O skill HyperFrames Registry permite que desenvolvedores instalem e integrem blocos e componentes reutilizáveis em composições HyperFrames usando o comando `hyperframes add`. Blocos são sub-composições independentes com suas próprias dimensões e timeline, que são incluídas via `data-composition-src` em uma composição hospedeira. Componentes, por outro lado, são snippets de efeito que não possuem dimensões próprias e são colados diretamente no HTML da composição hospedeira. O skill cobre o fluxo completo: desde a instalação de itens do registro, passando pela configuração de caminhos no `hyperframes.json`, até a 'fiação' (wiring) de blocos e componentes em `index.html`. Também oferece comandos para descoberta de itens disponíveis via curl no manifesto do registro. Este skill é essencial para usuários do HyperFrames que desejam acelerar a criação de composições visuais modulares e reutilizáveis.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

HyperFrames Registry

O registro fornece blocos e componentes reutilizáveis instaláveis via hyperframes add <nome>.

  • Blocos — sub-composições independentes (com suas próprias dimensões, duração e timeline). Incluídos via data-composition-src em uma composição hospedeira.
  • Componentes — snippets de efeito (sem dimensões próprias). Colados diretamente no HTML de uma composição hospedeira.

Quando usar este skill

  • O usuário menciona hyperframes add, "bloco", "componente" ou hyperframes.json
  • A saída de hyperframes add aparece na sessão (caminhos de arquivos, snippet da área de transferência)
  • Você precisa conectar um item instalado a uma composição existente
  • Você deseja descobrir o que está disponível no registro

Referência rápida

hyperframes add data-chart              # instalar um bloco
hyperframes add grain-overlay           # instalar um componente
hyperframes add shimmer-sweep --dir .   # mirar em um projeto específico
hyperframes add data-chart --json       # saída em formato legível por máquina
hyperframes add data-chart --no-clipboard  # pular área de transferência (CI/headless)

Após a instalação, a CLI imprime quais arquivos foram gravados e um snippet para colar em sua composição hospedeira. O snippet é um ponto de partida — você precisará adicionar os atributos data-composition-id (deve corresponder ao ID interno da composição do bloco), data-start e data-track-index ao conectar blocos.

Nota: hyperframes add funciona apenas para blocos e componentes. Para exemplos, use hyperframes init <dir> --example <nome>.

Locais de instalação

Blocos são instalados em compositions/<nome>.html por padrão. Componentes são instalados em compositions/components/<nome>.html por padrão.

Esses caminhos são configuráveis em hyperframes.json:

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

Veja install-locations.md para detalhes completos.

Conectando blocos

Blocos são composições independentes — inclua-os via data-composition-src no seu index.html hospedeiro:

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

  • data-composition-src — caminho para o arquivo HTML do bloco
  • data-composition-id — deve corresponder ao ID interno do bloco
  • data-start — quando o bloco aparece na timeline do hospedeiro (segundos)
  • data-duration — quanto tempo o bloco é reproduzido
  • data-width / data-height — dimensões do canvas do bloco
  • data-track-index — ordenação de camadas (maior = na frente)

Veja wiring-blocks.md para detalhes completos.

Conectando componentes

Componentes são snippets — cole seu HTML na marcação da sua composição, seu CSS no seu bloco de estilo e seu JS no seu script (se houver):

  1. Leia o arquivo instalado (ex.: compositions/components/grain-overlay.html)
  2. Copie os elementos HTML para dentro do <div data-composition-id="..."> da sua composição
  3. Copie o bloco <style> para os estilos da sua composição
  4. Copie qualquer conteúdo <script> para o script da sua composição (antes do código da timeline)
  5. Se o componente expõe integração com timeline GSAP (veja o bloco de comentários no snippet), adicione essas chamadas à sua timeline

Veja wiring-components.md para detalhes completos.

Descoberta

Navegue pelos itens disponíveis:

# Ler o manifesto do registro
curl -s https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry/registry.json

O registry-item.json de cada item contém: nome, tipo, título, descrição, tags, dimensões (apenas blocos), duração (apenas blocos) e lista de arquivos.

Veja discovery.md para detalhes sobre filtragem por tipo e tags.

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.

Habilidades Relacionadas