Communitygithub.com

bassam1998new-ops/hyperframes-students

Configuração inicial para o estúdio HyperFrames para alunos. Verifica Git, Node.js, FFmpeg e o navegador de renderização, explica o que está faltando, recomenda instalações, pede permissão antes de instalar e cria um vídeo de teste de 3 segundos para provar que tudo funciona.

O que é hyperframes-students?

Esta skill é projetada para configurar o ambiente de trabalho de um aluno iniciante que deseja usar o HyperFrames, um estúdio de criação de vídeos baseado em IA. Ela verifica automaticamente se ferramentas essenciais como Git, Node.js (versão 22 ou superior), npm e FFmpeg estão instaladas e funcionando corretamente. Caso alguma ferramenta esteja faltando, a skill explica de forma simples o que é cada uma e permissão antes de instalar, garantindo que o aluno entenda cada etapa. Após a instalação, a skill também configura as dependências do projeto, como o navegador Chrome privado para renderização e as regras oficiais do HyperFrames. Por fim, cria um vídeo de teste de 3 segundos para validar que todo o ambiente está operacional. A skill é especialmente útil para alunos que dizem 'setup', 'install', 'não funciona' ou quando o comando `npx hyperframes doctor` mostra algum item vermelho. É seguro executá-la novamente, pois ela pula as etapas já concluídas. Suporta Windows (via winget), macOS (via Homebrew) e Linux (via apt).

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bassam1998new-ops/hyperframes-students/tree/HEAD/.claude/skills/setup

Perguntar na sua IA favorita

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

Documentação

Setup — preparar o computador de um iniciante

O aluno é um iniciante. Fale na linguagem dele, frases curtas, um passo de cada vez. Faça as verificações você mesmo. Peça permissão antes de cada instalação. Nunca digite uma senha por ele.

0. Está na pasta certa?

Isso deve ser executado dentro da pasta do estúdio (ela tem CLAUDE.md e video-projects/_library/). Se você estiver em outro lugar, encontre a pasta ou pergunte onde ele a clonou, e use cd para ir até lá.

1. Verificar o que já existe

Descubra o sistema (Windows / macOS / Linux) e execute esses comandos. Não mostre a saída bruta; mostre uma pequena lista.

VerificaçãoComandoNecessário?O que é, em uma linha
Gitgit --versionsimbaixa este estúdio e suas atualizações
Node.js 22 ou mais novonode --versionsimexecuta o HyperFrames
npmnpm --versionsimvem com Node.js
FFmpeg + FFprobeffmpeg -version, ffprobe -versionsimjunta os frames e o som em um MP4
Disco livre(o doctor mostra)~3 GBpara as ferramentas e seus vídeos

Mostre assim:

✓ Git
✗ Node.js — não instalado (necessário: executa o HyperFrames)
✓ FFmpeg

Se tudo estiver ✓, diga isso e vá para o passo 3.

2. Instalar o que está faltando — pergunte primeiro, um de cada vez

Para cada ✗: diga o que é (uma linha), que é gratuito, o que você recomenda e pergunte "Devo instalar?" Aguarde um "sim".

Windows (winget já vem embutido no Windows 10/11):

  • Node.js: winget install -e --id OpenJS.NodeJS.LTS --accept-package-agreements --accept-source-agreements
  • FFmpeg: winget install -e --id Gyan.FFmpeg --accept-package-agreements --accept-source-agreements
  • Git: winget install -e --id Git.Git --accept-package-agreements --accept-source-agreements
  • Se o Windows mostrar uma caixa "Deseja permitir que este aplicativo faça alterações?", peça para clicarem em Sim.
  • Se o winget estiver faltando: envie-os para https://nodejs.org (o botão LTS), https://git-scm.com e para o FFmpeg diga "instale o App Installer pela Microsoft Store, e então tentarei novamente".

macOS (usa Homebrew):

  • Verifique brew --version. Se estiver faltando, eles devem executar o instalador sozinhos, porque ele pede a senha do Mac. Diga a eles: abra o aplicativo Terminal, cole o comando de https://brew.sh, pressione Enter, digite a senha do Mac (ela fica invisível enquanto digita — é normal) e avise quando terminar.
  • Depois: brew install node ffmpeg git

Linux: esses comandos precisam da senha, então eles executam no próprio terminal: sudo apt install -y git ffmpeg. Para Node.js 22+, recomende o instalador LTS de https://nodejs.org.

Depois de instalar algo: o novo programa ainda não está visível para esta janela do Claude. Diga a eles: "Feche o Claude Code completamente, abra-o novamente nesta mesma pasta e digite /setup — continuarei daqui." Então pare e aguarde. (Quando voltarem, o passo 1 mostrará o novo ✓.)

3. Instalar as partes do próprio estúdio

Diga o que cada uma faz e aproximadamente o tamanho, depois execute-as em ordem:

  1. npm install — baixa o HyperFrames para esta pasta (cerca de 120 MB, aproximadamente um minuto).
  2. npx hyperframes skills — ensina ao Claude as regras oficiais do HyperFrames (pequeno). Pergunte primeiro: instala skills para o Claude neste computador.
  3. npx hyperframes browser ensure — baixa uma cópia privada do Chrome usada apenas para fazer vídeos (~150 MB). O navegador normal deles não é tocado.
  4. npx hyperframes doctor — a verificação final. Explique apenas os itens vermelhos que importam: Node.js, FFmpeg, FFprobe e Chrome devem estar ✓. Estes são opcionais — ignore-os: uma versão mais nova disponível, whisper-cpp (legendas automáticas), MusicGen (música com IA), Docker.

Após npx hyperframes skills: novas skills carregam em uma nova sessão. Diga a eles: "Feche o Claude Code e abra-o novamente nesta pasta, depois digite /setup — continuarei no vídeo de teste."

4. Provar que funciona: um vídeo de teste de 3 segundos

Precisa de internet (a biblioteca de animação carrega da web). Execute um por linha (no PowerShell, && não funciona):

mkdir my-videos
cd my-videos
npx hyperframes init hello-test --example blank --resolution portrait --non-interactive
cd hello-test

O exemplo "blank" tem 10 segundos e mostra "Title". Em index.html: mude o texto para o nome do aluno ou "Hello", defina ambos data-duration="10" para 3, adicione um fade-in (tl.fromTo("#title", { opacity: 0 }, { opacity: 1, duration: 0.6 }, 0);) e tl.set({}, {}, 3); antes da linha window.__timelines. Depois:

npx hyperframes lint
npx hyperframes render --quality draft

Encontre o MP4 em my-videos/hello-test/renders/, diga a eles onde está e ofereça-se para abri-lo. Se falhar, leia o erro, corrija-o e tente novamente. Não entregue uma etapa quebrada.

5. Concluído

Diga a eles, de forma resumida:

  • "A configuração está concluída. Seus vídeos vão ficar na pasta my-videos."
  • "Para fazer um vídeo, digite /new-video."
  • "Da próxima vez, abra o Claude Code nesta mesma pasta." Diga a eles o caminho completo da pasta que você usou e como:
    • Aplicativo Claude desktop: guia Código → escolher / abrir pasta → selecione essa pasta.
    • Terminal: cd "<caminho completo>" depois claude.
  • No Windows, "Documentos" pode estar dentro do OneDrive (OneDrive\Documents). Verifique onde o clone realmente caiu e forneça esse caminho exato.

Individual skills in this repo

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

bassam1998new-ops/hyperframes-students

Make a new video with a beginner, start to finish — a few easy questions, pick a look from this repo's styles, build it with HyperFrames, check the frames, render and show it. Use when the student says "new video", "make a video", "اعمل فيديو", "عايز فيديو", "reel", "animation", or asks how to start a video. Hands the technical HyperFrames rules to the official hyperframes skills.

bassam1998new-ops/hyperframes-students

Build a video in the Amber Grid Newsroom look (style card amber-grid-newsroom) — a hot "breaking news" desk: near-black grid field, the real screen recording in a framed window with instant reframes, an English title over an Arabic title line, and karaoke captions where the spoken word turns hot. Use when the director picked this card, or the owner says "make it in the amber newsroom style", "news desk", "breaking news look", "زي ريل opus 5.5", "ستايل الأخبار", or the video is AI news or a build show-off cut from his OBS screen recording with an Egyptian Arabic voice-over. 9:16 reels. Not for lecture clips or direct offers.

bassam1998new-ops/hyperframes-students

Build a video in the Cream Caret Type look (style card cream-caret-type) — Arabic words typed with a coloured caret on a flat two-colour page (night and paper that swap on hard cuts), select-highlight → delete → retype, a flat profile silhouette, one coloured dot that match-cuts into a flat vector eye, a zoom-through the iris, a fixed noun with a bold verb swapping every 16 frames, a pixel-art icon on the sign-off and a monogram end card — one sound per event, silence between. Use when the director picked this card, or the owner says "the typing intro", "caret type", "cream caret", "زي فيديو الكتابة", "الكلام اللي بيتكتب", "intro بالكتابة", or the video is a channel / "who am I" intro, a course or service intro hook, a short opener before a talking head, a word-play promise line or a bumper. 9:16 only, Arabic-first. Not for talking heads the whole time, screen-recording proof, data-heavy explainers or full spoken subtitles. DRAFT — untested.

bassam1998new-ops/hyperframes-students

Build a video in the Floating Desk Zoom look (style card floating-desk-zoom) — real app windows float as cards on warm paper, a virtual camera hard-cuts in on the action, follows the typing and glides back out. Use when the director picked this card, or the owner says "make it in the floating desk style", "paper desk", "zoom on the screen like the launch video", "اعمله على الورق", or the video is a build show-off, quick tutorial or AI news made from his OBS screen recording with a voice-over. Arabic or English; 9:16 reels. Not for lecture clips or talking heads.

bassam1998new-ops/hyperframes-students

Build a video in the Hatch Cosmos look (style card hatch-cosmos) — a hand-drawn pencil-hatched world on one canvas, a block mascot (or a pair) that walks, looks, blinks and does ^ ^ eyes, a dive through its eye into a hatched galaxy of nebula blobs, tilted rings and needle stars. Use when the director picked this card, or the owner says "hatched", "hatch cosmos", "pencil cosmos", "the galaxy video style", "the mascot dive", "زي فيديو المجرة", "الستايل المرسوم بالقلم", "الكائن اللي بيدخل في عينه", or the video is a music-led show-off/teaser, a concept intro with a mascot, a "journey inside" beat or a channel bumper. 9:16 and 16:9 both built. Not for talking heads, real screen-recording proof, data-heavy explainers or photographic looks.

bassam1998new-ops/hyperframes-students

Build a video in the Horizon Prompt One-shot look (style card horizon-prompt-oneshot) — one continuous camera on a near-black stage lit by a soft planet-horizon glow; a glass app bar, a cursor and a prompt box morph into each other, a prompt is typed, the send button grows into a tile that blooms into a full-frame result, then a light wipe to a logo end card, every beat hit-synced to a UI sound. Use when the director picked this card, or the owner says "horizon prompt", "the prompt one-shot", "the ChatGPT-style promo", "زي فيديو البرومبت", "الكيرسر اللي بيكتب البرومبت", or the video is an AI tool show-off / prompt-to-result demo, a course or service promo opener, a launch teaser or a channel bumper. Not for talking heads, real screen-recording proof, data-heavy explainers or long tutorials. DRAFT — untested.

bassam1998new-ops/hyperframes-students

Remix 2+ existing style cards of the Hyperframes video workspace into one NEW draft style card, layer by layer (palette roles, type, texture, grade, camera, light, edit rhythm, transitions, motion, sound, prompt parts), then let the owner pick the skills for the video and start the director. Use when the owner says "hybrid style", "remix styles", "mix two styles", "combine styles", "اعمل هايبرد", "ادمج الستايلين", or ticks cards and presses "Remix these" on the Styles board.

bassam1998new-ops/hyperframes-students

Build a video in the Midnight Kinetic Type look (style card midnight-kinetic-type) — clean motion type on a flat dark field, word-by-word mask rises, one accent word that lands alone, icon strokes that draw on, and hard cuts on the music's beat grid. Use when the director picked this card, or the owner says "make it in the kinetic type style", "midnight type", "like an earlier project", "تايبوجرافي متحركة", or the video is a direct offer, proof / results reel or AI news told with type, music and SFX (no face, no footage). Arabic (Cairo, per-word) and English (Inter) versions; 9:16 reels. Not for lecture clips or quick tutorials.

bassam1998new-ops/hyperframes-students

Build a video in the Midnight Screen Desk look (style card midnight-screen-desk) — a calm, organised news desk in three fixed zones: an Arabic info card on top, the real screen recording in a glowing band with punch-ins in the middle, and word-by-word captions (dim → bright) below. Use when the director picked this card, or the owner says "make it in the screen desk style", "three zones", "like the AI releases reel", "كارت فوق والشاشة في النص", or the video is AI news, a build show-off or a quick tutorial cut from his screen recording with an Egyptian Arabic voice-over. 9:16 reels. Not for lecture clips or direct offers.

bassam1998new-ops/hyperframes-students

Build a video in the Mint Lecture Room look (style card mint-lecture-room) — a calm classroom cut of a real lesson: one long take with slow zooms that follow the point, a topic lower third, a quiz card that asks, counts down think-time and then answers, and karaoke captions that light the current word. Use when the director picked this card, or the owner says "make it in the lecture room style", "lecture clip", "course cut", "quiz card", "قص من المحاضرة", "سؤال وجواب", or the video is a lecture clip or quick tutorial cut from his AI course recordings (Egyptian Arabic). 9:16 reels. Not for AI news or direct offers.

bassam1998new-ops/hyperframes-students

Build a video in the Neon Node Explainer look (style card neon-node-explainer) — a plain stage, one headline per spoken sentence, and one small glowing diagram (tiles, lines, packets, checks, terminal, tool list) that builds itself part by part. Use when the director picked this card, or the owner says "make it in the neon node style", "node explainer", "API vs MCP style", "اعمله زي فيديو الـ MCP", or the video is an AI explainer, concept explainer, quick tutorial or AI news with a voice-over and no face. Arabic headlines + English mono labels; 9:16 and 16:9 both built. Not for talking heads, warm stories, real screen-recording demos or music-only hype reels.

bassam1998new-ops/hyperframes-students

Build a video in the Swiss Motion Reel look (style card swiss-motion-reel) — a Swiss-grid "instrument panel" with a constant thin HUD, flat 2-colour blocks, word slams, shape match-cuts and hard cuts on a 128 BPM beat. Use when the director picked this card, or the owner says "make it in the Swiss style", "motion reel", "like the motion designer reel", "HUD reel", "ستايل سويسري", or the video is a brand sizzle, product intro, "what we do" reel, launch teaser or any no-person, graphics-only, music-led video. Latin display type with Arabic in a clean geometric sans; built and tested in 16:9, 9:16 still to build. Not for talking heads, screen-recording tutorials or long voice-led explainers.

bassam1998new-ops/hyperframes-students

Build a video in the Warm Glass Face-cam look (style card warm-glass-facecam) — the presenter talks to camera while frosted-glass panels with one warm glow land exactly where he points; blur-punch text, a karaoke pill, small charts, and a shrink into a rounded picture-in-picture for the demo part. Use when the director picked this card, or the owner says "make it in the warm glass style", "glass panels over my face", "face-cam with glass cards", "PiP intro", "كروت زجاج وأنا بتكلم", or the video is a build show-off or quick tutorial with the owner on camera. Source is English 16:9; the 9:16 and Arabic versions still have to be built at the first job. Not for lecture clips or AI news.

bassam1998new-ops/hyperframes-students

Build a video in the <Style name> look (style card <slug>). Use when the director picked this style card, when the owner says "make it in the <Style name> style", "<slug>", "استايل <Style name>", or the video type is <video types from use_when>. Works for Arabic (Egyptian) and English, 9:16 reels<, and 16:9 if supported>. Not for <avoid_when>.

Habilidades Relacionadas