Communitygithub.com

lzcjsyr/Book2Video

Fluxo de trabalho genérico para criação de composições de vídeo HyperFrames personalizadas em qualquer formato ou duração — peças longas ou em várias cenas, reels de marca/montagens, cartões de título, loops estáticos e composições livres. Independente de entrada ou duração. Se um fluxo de trabalho especializado se encaixar claramente (produto comercializado, site, explicador, PR do GitHub, filmagens existentes, motion graphics curtos ou port do Remotion), dê preferência a ele (veja /hyperframes). Use este apenas como fallback geral.

O que é Book2Video?

O **Book2Video** (general-video) é um fluxo de trabalho fallback para o HyperFrames, projetado para criar composições de vídeo personalizadas quando nenhum fluxo especializado se aplica. Ele é agnóstico em relação à entrada e duração, adequado para peças longas, reels de marca, cartões de título e loops. O fluxo exige uma verificação rigorosa: antes de codificar, o agente deve confirmar que possui uma identidade visual fundamentada em especificações ou no guia de estilo (`house-style.md`), um ângulo conceitual, um par de fontes da lista embutida e um plano de densidade de primeiro plano. Ele segue um processo estruturado: descoberta (entendimento do público e plataforma), estabelecimento do sistema de design, expansão do prompt (para cenas múltiplas), planejamento da estrutura e ritmo, e layout antes da animação – posicionando todos os elementos no estado final (mais visível) antes de adicionar movimento com GSAP. Para áudio, ele utiliza um mecanismo unificado (`hyperframes-media`) que gera TTS, BGM e SFX, com fallback automático entre serviços (HeyGen, ElevenLabs, etc.). O fluxo é compatível com os sistemas HyperFrames (creative, animation, core, media) e é executado via `hyperframes-cli`. A saída final segue uma checklist que inclui verificação de lint, visualização das cenas e renderização.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/lzcjsyr/Book2Video/tree/HEAD/skills/step4/general-video

Perguntar na sua IA favorita

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

Documentação

media-use: Antes de buscar áudio/imagens, chame /media-use para resolver BGM/SFX/imagens do catálogo HeyGen. Execute --adopt primeiro para registrar assets existentes. Veja a skill /media-use.

general-video — fluxo de trabalho de vídeo geral

Confirme a rota antes de construir. Este é o fallback para criação de composições personalizadas. Se a entrada se encaixar claramente em um fluxo especializado, dê preferência a ele: produto comercializado → /product-launch-video; site geral → /website-to-video; explicador de tópico → /faceless-explainer; PR do GitHub → /pr-to-video; filmagens existentes → /embedded-captions · /talking-head-recut; motion graphic curto sem narração → /motion-graphics; port do Remotion → /remotion-to-hyperframes. Fora do escopo: dados ao vivo/no momento da renderização, edição no estilo NLE de um vídeo finalizado, ou produção de filmagens que o HyperFrames não pode capturar. Não tem certeza? Leia /hyperframes primeiro.

Construa exatamente o que foi solicitado. Um cartão de título é um cartão de título — não um cartão de título + três cenas de apoio + música ambiente + legendas. Se cenas ou elementos extras melhorariam genuinamente a peça, proponha-os; não os adicione silenciosamente. Para pequenas edições (corrigir uma cor, ajustar uma duração, adicionar um elemento), pule as etapas de planejamento e vá direto para a construção.

Abordagem

Descoberta — apenas para solicitações abertas

Para solicitações vagas e exploratórias ("faça algo para nossa marca", "uma introdução legal") — entenda a intenção antes de escolher cores:

  • Público — quem assiste? desenvolvedores / executivos / consumidores em geral?
  • Plataforma — onde será exibido? redes sociais (15s) / hero do site / demo de produto / interno?
  • Prioridade — o que mais importa? qualidade do movimento / precisão do conteúdo / fidelidade à marca / velocidade?
  • Variações — uma melhor versão, ou 2-3 opções significativamente diferentes (ritmo, energia ou estrutura diferentes — não apenas trocas de cor)?

Para solicitações específicas ("adicione um cartão de título", "corrija o timing da cena 3"), pule a descoberta.

Passo 1 — Sistema de design → hyperframes-creative

Primeiro, estabeleça a identidade visual. Se o projeto tiver uma especificação de design, leia-a (precedência: frame.md → design.md → DESIGN.md; trate como verdade da marca — cores exatas, fontes, restrições).

Se não houver especificação, você DEVE ler AMBOS hyperframes-creative/references/house-style.md E hyperframes-creative/references/video-composition.md antes de escolher qualquer cor ou fonte. house-style.md fornece a abertura "interpretar o prompt / gerar conteúdo real", a lista lazy-default e a receita de camadas; video-composition.md fornece as regras de densidade/escala do meio de vídeo / detalhamento do primeiro plano (barras de dados, marcas de registro, metadados monoespaçados, "8-10 elementos, dois que o usuário não pediu") que separa "produzido" de "gerado." Ler apenas um é o erro mais comum — video-composition.md é aquele que os agentes pulam, e é exatamente o que impede uma saída plana, centralizada e parecida com página web. Não invente uma paleta e pule estes; cruzar para hyperframes-creative é obrigatório aqui, não um ramo opcional. A partir daí, também puxe um estilo/humor nomeado → references/visual-styles.md, ou o seletor interativo → references/design-picker.md, conforme necessário. A especificação/estilo define a marca, não as regras de composição.

Encontre o ângulo (briefing vago, sem especificação): antes de escolher as cores, escreva UMA frase — o que este nome/palavra/tópico evoca, e qual mundo visual (metáfora, cenário, instrumento, motivo) o expressa? Exemplo: uma ferramenta de cibersegurança → portas de cofre / linhas de varredura de perímetro / linguetas de fechadura; um app de meditação → maré, respiração, florescimento de luz lenta. Leia o significado do assunto, não apenas suas letras; escolha um ângulo concreto em vez de um reestilo literal. Este é o substituto barato para a expansão do prompt (Passo 2) em peças de cena única, onde a expansão é corretamente pulada — e é a diferença entre um conceito projetado e um logotipo genérico sobre um gradiente.

Passo 2 — Expansão do prompt → hyperframes-creative

Execute para toda composição de várias cenas (pule para peças de cena única e edições triviais). Fundamentar a solicitação com a especificação de design + estilo da casa em um intermediário consistente que o trabalho downstream leia da mesma forma. Veja hyperframes-creative/references/prompt-expansion.md.

Passo 3 — Planejamento

Antes de escrever HTML, pense em alto nível:

  1. O quê — a experiência do espectador: arco narrativo, momentos-chave, batidas emocionais.
  2. Estrutura — quantas composições, sub-composição vs. inline, quais faixas transportam vídeo / áudio / sobreposições / legendas. Para a decisão monolítico-arquivo-único vs. modular-sub-comp, veja hyperframes-core/references/composition-patterns.md § Duas Arquiteturas (regra prática: ≥3 cortes de cena duros, ou qualquer cena reutilizada → modularize; uma peça curta de cena única permanece em um arquivo).
  3. Ritmo — nomeie o padrão antes de implementar (ex.: rápido-rápido-LENTO-SHADER-pausa); veja hyperframes-creative/references/beat-direction.md.
  4. Timing — quais clipes determinam a duração, onde as transições ocorrem, o ritmo.
  5. Layout — construa o estado final primeiro (veja abaixo).
  6. Animar — depois adicione movimento via hyperframes-animation.

Layout Antes da Animação

Posicione cada elemento onde ele fica em seu momento mais visível — totalmente entrado, colocado corretamente, ainda não saindo. Escreva isso como HTML + CSS estático primeiro. Ainda sem GSAP.

Por quê: se você posicionar elementos em seu estado inicial animado (fora da tela, escalado para 0, opacidade 0) e animar para onde você acha que eles vão pousar, você está adivinhando o layout final — sobreposições permanecem invisíveis até a renderização. Construa o estado final primeiro e você vê e corrige problemas de layout antes de adicionar movimento.

  1. Identifique o quadro herói para cada cena — o momento em que o maior número de elementos está simultaneamente visível. Esse é o layout que você constrói.
  2. Escreva CSS estático para esse quadro. O contêiner de conteúdo deve preencher a cena com preenchimento, não com deslocamentos absolutos:
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px; /* padding posiciona o conteúdo; preenche qualquer tamanho de cena */
  gap: 24px;
  box-sizing: border-box;
}

Nunca use position: absolute; top: Npx em um contêiner de conteúdo — ele transborda quando o conteúdo é mais alto que o espaço. Reserve o posicionamento absoluto para elementos decorativos.

⚠ O width/height: 100% acima só funciona se cada ancestral tiver uma altura resolvida. O <div data-composition-id> raiz e qualquer invólucro entre ele e .scene-content devem ser dimensionados (position: relative; width: 1920px; height: 1080px na raiz — veja hyperframes-core → "Raiz deve ser dimensionada"). Pule isso e o contêiner flexível colapsa para ~0, o conteúdo se acumula no canto superior esquerdo, e o primeiro glifo corta em x=0 — enquanto lint/inspect ainda relatam 0 problemas. E sempre mantenha o padding (≥80px) no .scene-content: é a margem de segurança do título. Nunca o substitua por gap puro.

  1. Adicione entradas — anime DE fora da tela/invisível PARA a posição CSS com gsap.from() (em sub-composições prefira gsap.fromTo() para que o estado inicial seja explícito; veja hyperframes-core/references/sub-compositions.md). A posição CSS é a verdade fundamental; o tween é a jornada até ela.
  2. Saídas são tratadas por transição — de acordo com as regras de transição de cena em hyperframes-animation/transitions/, apenas a cena final anima elementos para fora; entre cenas, a transição É a saída.

Espaço compartilhado ao longo do tempo: se o elemento A sai antes do elemento B entrar na mesma área, ambos ainda precisam de posições CSS corretas para seus respectivos quadros herói — a ordenação da linha do tempo impede que coexistam, e a etapa de layout detecta sobreposição acidental. Brilhos/sombras em camadas e profundidade empilhada em z são sobreposição intencional; a etapa é sobre detectar colisões não intencionais (dois títulos um em cima do outro, conteúdo vazando para fora do quadro).

Construir — delegar para as habilidades de domínio

Isso mapeia a superfície completa da habilidade (veja a description) para suas referências — não exaustivo; quando uma intenção não estiver listada, roteie através de hyperframes-creative (aparência/conceito), hyperframes-animation (movimento), hyperframes-core (contrato), hyperframes-media (áudio/legendas). A primeira linha é ADITIVA — leia-a E a linha da sua intenção, não uma ou outra.

Construindo…Leia primeiro (em ordem)
SEMPRE — toda peça não trivial, além da sua linha de intenção abaixohyperframes-creative/references/house-style.md + references/video-composition.md (também bloqueado no Passo 1 / HARD-GATE; o detalhamento de primeiro plano "produzido, não gerado")
Tipografia cinética / foco em textohyperframes-animation/techniques.md (tipo cinético) + adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md
Cartão de título / terço inferior / sobreposição / PiP / texto atrás do sujeitohyperframes-creative/references/composition-patterns.md + (para o quadro centralizado/dimensionado) hyperframes-core → "Raiz deve ser dimensionada"
Revelação de logotipo / marcahyperframes-animation/rules/svg-path-draw.md (desenho) + rules/3d-text-depth-layers.md + rules/scale-swap-transition.md
Dados / estatísticas / númeroshyperframes-animation/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-creative/references/data-in-motion.md
Demo de produto / app / UIhyperframes-animation/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md
Reativo a áudio / orientado por músicahyperframes-creative/references/audio-reactive.md (pré-extrair bandas; mapear para movimento)
Narrado / voiceover / música / SFX / legendashyperframes-media → o mecanismo de áudio compartilhado scripts/audio.mjs (uma chamada = TTS + BGM + SFX → audio_meta.json); criação de legendas + posicionamento de assets via hyperframes-core. Veja Áudio abaixo.
Várias cenas / transiçõeshyperframes-animation/transitions/overview.md depois transitions/catalog.md (você não terminou após a visão geral — a receita GSAP está no catálogo)
Modular / sub-composiçõeshyperframes-core/references/composition-patterns.md + references/sub-compositions.md

Áudio: um mecanismo (TTS · BGM · SFX)

Somente quando a peça exigir (de acordo com "construa exatamente o que foi solicitado" — sem música ambiente em um cartão de título). Não crie TTS manualmente nem faça cópia de fornecedor: escreva um audio_request.json neutro e chame o mecanismo compartilhado em hyperframes-media. Ele faz degradação automática em um comutador — credencial HeyGen presente → TTS HeyGen + recuperação de música/SFX; ausente → geração TTS ElevenLabs/Kokoro, BGM Lyria/MusicGen e a biblioteca SFX fornecida. Lista completa de sinalizadores + esquema de solicitação/meta: o comentário de cabeçalho de hyperframes-media/scripts/audio.mjs.

// audio_request.json — uma linha por segmento narrado; `id` é seu (une audio_meta de volta)
{
  "lines": [
    { "id": "s1", "text": "Sua primeira frase.", "sfx": ["whoosh"] },
    { "id": "s2", "text": "A próxima batida." },
  ],
  "bgm": { "query": "fundo cinematográfico calmo" }, // omita "mode" → auto (recuperar se HeyGen, caso contrário gerar); "none" para desabilitar
}
# <MEDIA_DIR> = o diretório da skill hyperframes-media instalada (irmão desta skill)
node <MEDIA_DIR>/scripts/audio.mjs --request ./audio_request.json --hyperframes . --out ./audio_meta.json

Depois, leia audio_meta.json: monte cada voices[].path + (bgm.path, sfx[]) como faixas <audio> e use voices[].words para legendas, tudo de acordo com hyperframes-core (faixas de áudio + criação de legendas). Se o BGM seguiu o caminho de geração (bgm_pending: true), execute hyperframes-media/scripts/wait-bgm.mjs antes da renderização final.

Checklist de saída → hyperframes-cli

Individual skills in this repo

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

lzcjsyr/Book2Video

将 PDF、EPUB、DOCX 等书籍或长文档一次性转成约 4 分钟的中文读书带货短视频口播稿,以情绪共鸣、观看留存和购买欲为核心,直接输出 Book2Video 后续流程可读取的 raw JSON。用户提到读书带货、图书推广、卖书口播、商品卡、走心书单视频、情绪型读书文案或要求生成可直接进入视频流水线的带货稿时使用。

lzcjsyr/Book2Video

将长书、长文档转成中文视频号读书解说稿;先抽取文本并建立可恢复覆盖台账,覆盖自检通过后再按入口定义的正文长度生成初稿、多轮修订和最终 raw JSON。

lzcjsyr/Book2Video

将长书、长文档、PDF、EPUB、读书资料、思想经典、社科著作、商业书或研究型长文转成更有传播感的中文视频号/抖音读书口播稿,并输出项目可用的 raw JSON。只要用户提到“读书解说”“拆书稿”“视频号口播”“把这本书做成短视频”“长文档转视频脚本”“生成标题/封面/金句/raw JSON”,都应使用此 skill。

lzcjsyr/Book2Video

Cody的公众号长文写作skill。当用户需要撰写公众号文章、写稿子、续写文章、根据素材产出长文时使用。触发词包括但不限于:写文章、写稿子、帮我写、续写、扩写、公众号文章、长文、出稿、按我的风格写。即使用户只是说"帮我把这个写成文章"或"用我的风格写一下",只要上下文涉及内容创作和公众号输出,都应该触发。也适用于用户丢过来一个PDF、brief、新闻链接、语音转文字或任何素材说"帮我写篇文章"的场景。不要用于短内容(小红书帖子、推特、朋友圈)或纯标题摘要生成。

lzcjsyr/Book2Video

将中短篇专业报告、公司财报、券商研报、招股书、宏观经济分析及含有较多表格和数据的PDF文档,转化为高品质、数据精准的中文视频号/抖音口播解说稿。只要用户提到“研报”、“财报”、“商业分析报告”或需要“解读数据”、“把报告/PDF做成短视频”,务必使用此 Skill。

lzcjsyr/Book2Video

简化版的文稿生成技能。能够直接读取图书/文档,提取核心论点,生成高品质、口语化的视频号/抖音读书解说文稿并输出标准 JSON 格式。

Habilidades Relacionadas