Communitygithub.com

assafkip/claude-video-editor

Ferramenta CLI HyperFrames — hyperframes init, lint, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Use para scaffolding de projetos, linting ou validação de composições, pré-visualização no estúdio, renderização de vídeo, transcrição de áudio, geração de TTS ou depuração do ambiente HyperFrames.

O que é claude-video-editor?

O HyperFrames CLI é uma ferramenta de linha de comando projetada para desenvolvedores e agentes de IA que trabalham com edição de vídeo programática via composições HTML. Ele automatiza todo o fluxo de trabalho: desde a inicialização de um projeto (`init`) com estrutura de diretórios e arquivos de exemplo, passando pela validação (`lint`) que detecta erros como IDs de composição ausentes ou trilhas sobrepostas, até a pré-visualização em tempo real (`preview`) com recarregamento automático e renderização final (`render`) em MP4 ou WebM com suporte a qualidade draft, standard e high. Além disso, oferece transcrição de áudio/vídeo usando Whisper, conversão de texto em fala (TTS) com vozes variadas, diagnóstico do ambiente (`doctor`) e gerenciamento de atualizações. A CLI é executada via `npx hyperframes`, requer Node.js >= 22 e FFmpeg, e suporta dockers para saída reproduzível. É ideal para integrar em pipelines de CI/CD ou para agentes que precisam criar vídeos de forma automatizada e consistente.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/assafkip/claude-video-editor/tree/HEAD/skills/hyperframes-cli

Perguntar na sua IA favorita

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

Documentação

CLI HyperFrames

Tudo é executado por meio de npx hyperframes. Requer Node.js >= 22 e FFmpeg.

Fluxo de Trabalho

  1. Scaffolding — npx hyperframes init my-video
  2. Escrever — criar composição HTML (veja a skill hyperframes)
  3. Lint — npx hyperframes lint
  4. Pré-visualizar — npx hyperframes preview
  5. Renderizar — npx hyperframes render

Faça lint antes de pré-visualizar — detecta data-composition-id ausente, trilhas sobrepostas, timelines não registradas.

Scaffolding

npx hyperframes init my-video                        # assistente interativo
npx hyperframes init my-video --example warm-grain   # escolher um exemplo
npx hyperframes init my-video --video clip.mp4        # com arquivo de vídeo
npx hyperframes init my-video --audio track.mp3       # com arquivo de áudio
npx hyperframes init my-video --non-interactive       # pular perguntas (CI/agentes)

Modelos: blank, warm-grain, play-mode, swiss-grid, vignelli, decision-tree, kinetic-type, product-promo, nyt-graph.

init cria a estrutura correta de arquivos, copia mídia, transcreve áudio com Whisper e instala skills de codificação de IA. Use-o em vez de criar arquivos manualmente.

Linting

npx hyperframes lint                  # diretório atual
npx hyperframes lint ./my-project     # projeto específico
npx hyperframes lint --verbose        # achados em nível de informação
npx hyperframes lint --json           # legível por máquina

Verifica index.html e todos os arquivos em compositions/. Relata erros (devem ser corrigidos), avisos (devem ser corrigidos) e informações (com --verbose).

Pré-visualização

npx hyperframes preview                   # servir diretório atual
npx hyperframes preview --port 4567       # porta personalizada (padrão 3002)

Recarrega automaticamente com mudanças nos arquivos. Abre o estúdio no navegador automaticamente.

Renderização

npx hyperframes render                                # MP4 padrão
npx hyperframes render --output final.mp4             # saída nomeada
npx hyperframes render --quality draft                # iteração rápida
npx hyperframes render --fps 60 --quality high        # entrega final
npx hyperframes render --format webm                  # WebM transparente
npx hyperframes render --docker                       # idêntico byte a byte
FlagOpçõesPadrãoObservações
--outputcaminhorenders/name_timestamp.mp4Caminho de saída
--fps24, 30, 603060fps dobra o tempo de render
--qualitydraft, standard, highstandarddraft para iterar
--formatmp4, webmmp4WebM suporta transparência
--workers1-8 ou autoautoCada um inicia Chrome
--dockerflagdesligadoSaída reproduzível
--gpuflagdesligadoCodificação acelerada por GPU
--strictflagdesligadoFalha em erros de lint
--strict-allflagdesligadoFalha em erros E avisos

Orientação de qualidade: draft enquanto itera, standard para revisão, high para entrega final.

Transcrição

npx hyperframes transcribe audio.mp3
npx hyperframes transcribe video.mp4 --model medium.en --language en
npx hyperframes transcribe subtitles.srt   # importar existente
npx hyperframes transcribe subtitles.vtt
npx hyperframes transcribe openai-response.json

Texto-para-Fala

npx hyperframes tts "Texto aqui" --voice af_nova --output narracao.wav
npx hyperframes tts script.txt --voice bf_emma
npx hyperframes tts --list  # mostrar todas as vozes

Depuração

npx hyperframes doctor       # verificar ambiente (Chrome, FFmpeg, Node, memória)
npx hyperframes browser      # gerenciar Chrome integrado
npx hyperframes info         # versão e detalhes do ambiente
npx hyperframes upgrade      # verificar atualizações

Execute doctor primeiro se a renderização falhar. Problemas comuns: FFmpeg ausente, Chrome ausente, pouca memória.

Outros

npx hyperframes compositions   # listar composições no projeto
npx hyperframes docs           # abrir documentação
npx hyperframes benchmark .    # benchmark de desempenho de renderização

Individual skills in this repo

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

assafkip/claude-video-editor

Build videos from stills when there is nothing to cut — narration first (ElevenLabs v3 with audio tags), then still keyframes from ANY source (AI image tools, screenshots, photos, HyperFrames-rendered HTML), animated deterministically with the animate-stills recipe (HyperFrames camera moves + GSAP atmosphere). Use when the user wants an explainer, documentary-style video, or any video built from generated or collected visuals instead of recorded footage.

assafkip/claude-video-editor

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.

assafkip/claude-video-editor

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, and registry discovery.

assafkip/claude-video-editor

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.

assafkip/claude-video-editor

Beginner-friendly end-to-end video creator for HyperFrames. Use when the user says "make a video", "create a video", "new video", "build a video", "video from scratch", "I want to make a video", "help me create a video", or when someone who's never used HyperFrames before arrives with a concept, script, or rough idea and wants a finished MP4. Interviews the user in one pass, then builds the full video with mandatory preview and visual-verification gates.

assafkip/claude-video-editor

Build and iterate short-form vertical (9:16) videos in Hyperframes — TikTok/Reels/Shorts style. Use when Nate says "short-form video", "vertical video", "TikTok/Reels/Shorts", "make a short", "talking-head + motion graphics", or when the target is a 1080x1920 composition with face video + synced scene overlays + karaoke captions. Encodes the full May Shorts 19 playbook: face-mode choreography, audio-synced scene timing, karaoke captions, and the 10-rule quality checklist.

assafkip/claude-video-editor

Edit any video by conversation — the orchestrator for the bundled video pipeline. Use when the user wants to edit, cut, caption, grade, or add motion graphics to footage; drops a folder of clips and says "edit this"; or asks to make a promo/teaser/tutorial/short. Routes to video-use (the cut engine) and HyperFrames (motion-graphics overlays), with a motion-craft library for taste.

assafkip/claude-video-editor

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.

assafkip/claude-video-editor

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.

Habilidades Relacionadas