Communitygithub.com

oyi77/1ai-skills

Transforme qualquer texto — artigo, anotações, tópico, resumo — em um vídeo explicativo sem apresentador usando HyperFrames.

O que é 1ai-skills?

Esta skill gera vídeos explicativos 'sem rosto' (faceless) – ou seja, sem apresentador em cena, apenas narração e visuais inventados – a partir de qualquer texto fornecido pelo usuário. Ela é ideal para criar explicações de conceitos, tutoriais, listas animadas ou vídeos baseados em dados, onde cada quadro é composto por tipografia, gráficos abstratos, diagramas e visualizações de dados. A skill não captura telas de sites reais (para isso existe a `hyperframes-product-launch-video`). O fluxo de trabalho orienta o usuário a definir um sistema de design, planejar uma narrativa pedagógica, gerar storyboard, script e áudio, e, por fim, renderizar um vídeo MP4 completo. Suporta as plataformas HyperFrames e inclui scripts para gerenciamento de áudio, legendas e transições, garantindo que cada frame seja construído com base em blueprints de animação específicos para o conteúdo inventado.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/oyi77/1ai-skills/tree/HEAD/content/hyperframes-faceless-explainer

Perguntar na sua IA favorita

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

Documentação

Visão Geral

Esta skill constrói vídeos explicativos sem apresentador — baseados em narração, sem câmera — como composições HyperFrames. Use-a para explicações de produtos ou conceitos onde a voz sobreposta e os visuais transmitem a mensagem. Ela renderiza o MP4 final a partir de um script que você fornece.

HyperFrames — Explicador Sem Apresentador

Transforme texto arbitrário em um vídeo explicativo: escolha um sistema de design, planeje uma história de ensino e construa quadro a quadro. Sem apresentador significa que cada visual é inventado — não há etapa de captura e nenhum inventário de ativos reais.

Quando Usar

  • O usuário quer um explicador de tópico a partir de um artigo, anotações ou resumo
  • O usuário quer uma decomposição de conceito (como algo funciona)
  • O usuário quer um tutorial ou instrução (sem captura de tela)
  • O usuário quer uma lista animada ou lista com animação
  • O usuário quer um explicador baseado em dados (gráficos, estatísticas, comparações)

Quando NÃO Usar

  • O usuário quer um lançamento de produto (use hyperframes-product-launch-video)
  • O usuário quer um vídeo com apresentador falando (use hyperframes-embedded-captions)
  • O usuário quer um gráfico em movimento (use hyperframes-motion-graphics)
  • O usuário quer capturar um site (use hyperframes-product-launch-video)

Fluxo de Trabalho

0 · Configuração

npx hyperframes init "videos/<projeto>" --non-interactive --example=blank --skill=faceless-explainer

Escreva BRIEF.md imediatamente após o init (nunca antes — init recusa um diretório não vazio). Registre as preferências com node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes ..

1 · Brief (sem captura)

Salve a entrada completa do usuário literalmente:

  • capture/extracted/visible-text.txt — o artigo/anotações/tópico/resumo completo
  • capture/extracted/tokens.json — { "title": "", "description": "", "colors": [], "fonts": [] }

NÃO execute npx hyperframes capture — não há URL. Os visuais sem apresentador são inventados posteriormente.

2 · Sistema de Design

Escolha um preset de quadro cuja aparência se adapte ao tópico, tom e público:

node <SKILL_DIR>/scripts/build-frame.mjs --preset <nome> --hyperframes .

Isso copia o FRAME.md do preset → frame.md e remixa os tokens da marca. Um explicador sem apresentador geralmente não tem cores/fontes de marca → o script mantém a paleta do próprio preset.

3 · Storyboard e Roteiro

Transforme o texto em um plano de ensino quadro a quadro. A sequência do vídeo vem do design narrativo, não da ordem dos parágrafos do texto de entrada — reordene, mescle, omita, comprima.

Escreva STORYBOARD.md e (quando a narração for necessária) SCRIPT.md. Cada quadro precisa de:

  • focal / roles — os elementos visuais inventados (palavra herói, nó de diagrama, série de dados)
  • blueprint — a forma do plano (de hyperframes-animation/blueprints/)
  • transition_in — como o quadro entra

3.1 · Áudio

node <SKILL_DIR>/scripts/audio.mjs --script ./SCRIPT.md --storyboard ./STORYBOARD.md --hyperframes . --out ./audio_meta.json --voice <id-voz> &

Voz padrão do pipeline: Marcia (feminina) no HeyGen / am_michael no Kokoro. O clima da música de fundo vem do campo music: no storyboard.

Marcador silencioso canônico: music: none no bloco YAML superior de STORYBOARD.md E nenhum SCRIPT.md = projeto totalmente silencioso.

4 · Design Visual dos Quadros

Para cada quadro, escreva uma sequência de planos com código de tempo:

  • Escolha o blueprint do quadro (ou componha)
  • Instancie-o com o conteúdo inventado DESTE quadro
  • Ajuste a revelação de cada Cena à narração para que o quadro se desenvolva ao longo de sua duração total

Declare layout e movimento embutidos por Cena. Adicione um bloco ## Direção do vídeo para todo o vídeo.

5 · Construir Quadros

Aguarde o término do áudio da Etapa 3.1. Então:

node <SKILL_DIR>/scripts/audio.mjs sync-durations --audio-meta ./audio_meta.json --storyboard ./STORYBOARD.md
node <SKILL_DIR>/scripts/audio.mjs fetch-sfx --storyboard ./STORYBOARD.md --hyperframes .
node <SKILL_DIR>/scripts/frame-packets.mjs --project "$PROJECT_DIR" --storyboard "$PROJECT_DIR/STORYBOARD.md"

Despache um subagente por quadro. Cada trabalhador recebe:

  • _role.md (a função do trabalhador de quadro)
  • O pacote daquele quadro (bloco exato do storyboard + corpo do blueprint + receitas de regras citadas, embutidas)

Os trabalhadores escrevem apenas compositions/frames/NN-*.html. Eles nunca editam STORYBOARD.md.

Fundos com sangria total vão em uma camada class="clip", nunca em #root. O chão de um quadro é seu próprio clipe de fundo com duração total.

Construa as legendas em segundo plano e monte o índice:

node <SKILL_DIR>/scripts/captions.mjs build --storyboard ./STORYBOARD.md --audio-meta ./audio_meta.json --hyperframes . --out ./caption_groups.json &
node <SKILL_DIR>/scripts/assemble-index.mjs --storyboard ./STORYBOARD.md --hyperframes .

6 · Finalizar

node <SKILL_DIR>/scripts/transitions.mjs inject --storyboard ./STORYBOARD.md --hyperframes .
node <SKILL_DIR>/scripts/transitions.mjs verify --storyboard ./STORYBOARD.md --index ./index.html
npx hyperframes lint
npx hyperframes check
npx hyperframes snapshot --at <pontos-medios-dos-quadros>

Renderize somente após aprovação do usuário:

npx hyperframes render --skill=faceless-explainer --quality high --output renders/video.mp4

Tabela de Anti-Racionalização

RacionalizaçãoRealidade
"Vou capturar o site do artigo"Sem apresentador = sem captura. Visuais são inventados, não capturados
"Vou usar a ordem dos parágrafos do texto"O design narrativo decide a sequência, não a ordem da fonte
"Vou pular o sistema de design"frame.md é a fonte da verdade para cor/tipo/layout
"Vou colocar todo o conteúdo de uma vez e congelar"Ajuste as revelações à narração — o quadro se desenvolve ao longo de toda a duração
"Vou escrever um blueprint e reutilizá-lo"Cada quadro escolhe seu próprio blueprint com base no conteúdo
"Vou pular o áudio e usar só texto"O áudio é o relógio — todos os tempos de batida vêm dos timestamps das palavras
"Vou adicionar animações de espera entre as revelações"Cada fase executa — revelações em etapas, câmera com intenção ou UI sequenciada
"Vou centralizar a 42% para deixar espaço para legendas"Legendas são sobreposição — centralize no centro real (y = H/2)

Verificação

  • hyperframes.json e BRIEF.md existem
  • frame.md existe a partir de um preset nomeado
  • STORYBOARD.md existe com os campos narrativos necessários
  • SCRIPT.md existe quando a narração é necessária
  • Trabalho de áudio iniciado ou projeto marcado como silencioso
  • Cada quadro tem uma sequência de planos com código de tempo ajustada à narração
  • Cada quadro nomeia focal e/ou roles inventados
  • index.html existe
  • Legendas construídas ou explicitamente ignoradas
  • lint e check passaram antes da renderização
  • Usuário aprovou na pausa de revisão

Individual skills in this repo

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

oyi77/1ai-skills

Turn a weekly changelog .md into a finished branded changelog video using HyperFrames. Use when the user provides a changelog/digest markdown and wants the weekly video, or says 'changelog video'. Self-contained — fonts, background, lexicon, and scripts ship in the skill. Produces square 1080, ~45-60s videos with animated brand mock-UIs.

oyi77/1ai-skills

The transition technique catalog for HyperFrames videos — five velocity-matched SEAMS (zoom-through, inverse zoom-through, cut-the-curve, waterfall cut, rack-focus blur-cut) plus in-scene techniques (waterfall entry, nudge curve). Covers partial-travel velocity matching, Z scale-sign rule, size-scaled blur, the 10/65/25 slide ratio, and the 2-3 transition budget. Read before authoring any transition, text-beat handoff, or kinetic text entry.

oyi77/1ai-skills

Add captions/subtitles to talking-head or launch videos using HyperFrames. Use when the user wants embedded captions, verbatim caption rails, or cinematic text behind the subject. Covers the drop/rail/embed caption model, the overlay law (captions are NOT a reserved band), matte occlusion for embedded climaxes, and word-timestamp alignment from TTS output.

oyi77/1ai-skills

The fallback HyperFrames workflow for anything that doesn't fit other skills — longer multi-scene pieces, brand/sizzle reels, title cards, static loops, freeform compositions. Input- and length-agnostic. Also the home of companion mode (co-create with the full toolbox). Use when no other HyperFrames skill matches, or when the user wants a freeform video.

oyi77/1ai-skills

Create short, unnarrated, design-led motion graphics (~under 10s) using HyperFrames. Use when the user wants kinetic type, stat/chart hits, logo stings, lower-thirds, animated tweets/headlines, or transparent overlay motion graphics. MP4 or transparent overlay output. Teaches seek-safe keyframe authoring and the 2-3 transition budget rule.

oyi77/1ai-skills

Turn a music track into a beat-synced HyperFrames video — lyric, slideshow, or kinetic promo. Use when the user provides an audio file, a video to pull audio from, or a mood brief for generated music. Music drives pacing. Teaches beat-map extraction, section-based scene planning, and audio-reactive visuals.

oyi77/1ai-skills

Create product launch videos from a URL, brief, or script using HyperFrames (HTML→MP4). Use when the user wants a product launch video, site tour, social clip featuring a product's own visuals, or marketing/promoting a product. Up to ~3 min (sweet spot 30-90s). Teaches the HyperFrames production loop: plan → write HTML → wire seekable animations → add media → lint → preview → render.

oyi77/1ai-skills

The Video Production Manager — manages ALL video production under 1ai-content. Delegates to HyperFrames, Remotion, AI video, and FFmpeg based on the task. Has memory via 1ai-hub brain, follows 1ai-rules, and reports to Content Director. Use when the user says 'make a video', 'create video', 'edit video', 'video strategy', or needs any video production work.

oyi77/1ai-skills

Agent skill at content/video/gen/SKILL.md

oyi77/1ai-skills

Use when track portfolio company KPIs, variances, returns analysis. Use when user says "monitor portfolio", "track KPIs", "portfolio returns".

oyi77/1ai-skills

Use when go-to-market planning — launch sequencing, channel strategy, audience building, PR outreach. Use when planning product launches, building launch checklists, or coordinating multi-channel campaigns.

oyi77/1ai-skills

Use when portfolio manager — capital allocation, risk management, and performance metrics tracking for trading strategies.

Habilidades Relacionadas