Communitygithub.com

Kit de Ferramentas de Edição de Vídeo

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

O que é Kit de Ferramentas de Edição de Vídeo?

Este Kit de Ferramentas de Edição de Vídeo fornece uma interface padronizada para instalar e gerenciar blocos e componentes reutilizáveis dentro do ecossistema HyperFrames. Com suporte total para os ambientes de desenvolvimento Claude Code e Cursor, a skill automatiza o fluxo de trabalho de descoberta, instalação e integração de itens de registro em composições de vídeo existentes. A funcionalidade principal é acionada por meio do comando `hyperframes add`, que instala blocos (subcomposições independentes com suas próprias dimensões, duração e linha do tempo) ou componentes (snippets de efeito sem dimensões próprias). Após a instalação, o usuário pode conectar manualmente os itens em seu HTML de composição, utilizando atributos como `data-composition-src`, `data-composition-id`, `data-start` e `data-duration` para blocos, ou colando o HTML, CSS e JS fornecidos para componentes. A skill também oferece orientação para navegar pelo registro, descobrir itens disponíveis e configurar caminhos de instalação personalizados via arquivo `hyperframes.json`, garantindo flexibilidade e controle sobre o processo de edição de vídeo baseado em composições.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/govindgoel2001/video-editing-toolkit/tree/HEAD/vendor/hyperframes-skills/hyperframes-registry

Perguntar na sua IA favorita

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

Documentação

Registro HyperFrames

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

  • Blocos — subcomposições independentes (próprias dimensões, duração, linha do tempo). 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 esta skill

  • O usuário menciona hyperframes add, "bloco", "componente" ou hyperframes.json
  • A saída de hyperframes add aparece na sessão (caminhos de arquivo, 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              # instala um bloco
hyperframes add grain-overlay           # instala um componente
hyperframes add shimmer-sweep --dir .   # direciona um projeto específico
hyperframes add data-chart --json       # saída legível por máquina
hyperframes add data-chart --no-clipboard  # ignora á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 de composição interno 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 <name>.

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"
  }
}

Consulte install-locations.md para detalhes completos.

Conectando blocos

Blocos são composições independentes — inclua-os via data-composition-src em 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 linha do tempo hospedeira (segundos)
  • data-duration — por 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)

Consulte 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 bloco de estilo e seu JS no script (se houver):

  1. Leia o arquivo instalado (por exemplo, compositions/components/grain-overlay.html)
  2. Copie os elementos HTML para dentro da <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 de <script> para o script da sua composição (antes do código da linha do tempo)
  5. Se o componente expõe integração com a linha do tempo GSAP (veja o bloco de comentários no snippet), adicione essas chamadas à sua linha do tempo

Consulte wiring-components.md para detalhes completos.

Descoberta

Navegue pelos itens disponíveis:

# Leia 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.

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

Individual skills in this repo

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

govindgoel2001/video-editing-toolkit

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.

govindgoel2001/video-editing-toolkit

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

govindgoel2001/video-editing-toolkit

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For CLI commands (init, lint, preview, render, transcribe, tts) see the hyperframes-cli skill.

govindgoel2001/video-editing-toolkit

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

govindgoel2001/video-editing-toolkit

Edit any video by conversation. Transcribe, cut, color grade, generate overlay animations, burn subtitles — for talking heads, montages, tutorials, travel, interviews. No presets, no menus. Ask questions, confirm the plan, execute, iterate, persist. Production-correctness rules are hard; everything else is artistic freedom.

govindgoel2001/video-editing-toolkit

Production pipeline for mathematical and technical animations using Manim Community Edition. Creates 3Blue1Brown-style explainer videos, algorithm visualizations, equation derivations, architecture diagrams, and data stories. Use when users request: animated explanations, math animations, concept visualizations, algorithm walkthroughs, technical explainers, 3Blue1Brown style videos, or any programmatic animation with geometric/mathematical content.

Habilidades Relacionadas