Communitygithub.com

Reels-RSI

Reels-RSI — um diretor de reels de IA que evolui a cada vídeo. Transforma um tópico em um vídeo narrado, legendado e musicado, renderizado a partir de código (HyperFrames: SVG/Canvas/Three.js/mapas):科普讲解、历史简介/朝代/战役/人物、题目讲解(小学到高中数学/物理/化学/语文,板书+公式+笔顺)、故事短片. Foco em chinês (timing de palavras TTS, legendas CJK/bilíngues, subconjunto de fontes), também em inglês. Aprende com cada vídeo: verificações compiladas a partir de erros passados, lições, um benchmark. Use sempre que o usuário pedir um vídeo/视频/短片/讲解视频/历史视频/解题视频, como os explicadores virais feitos por IA, ou digitar /reels.

O que é Reels-RSI?

Reels-RSI é uma skill de agente de IA que atua como um diretor de vídeos no estilo "reels" (curtas) que aprende e melhora continuamente com cada vídeo produzido. Ela transforma um tópico em um vídeo completamente narrado, legendado e musicado, renderizado frame a frame a partir de código (SVG, Canvas, Three.js, mapas) usando o HyperFrames e um navegador headless Chrome — sem depender de modelos de vídeo. A skill suporta múltiplos gêneros: vídeos educativos de ciência e cultura, história (dinastias, batalhas, personagens), resolução de exercícios (matemática, física, química, línguas) com quadro negro e caligrafia, curtas de histórias e muito mais. O foco inicial é chinês (com timing de palavras TTS, legendas CJK ou bilíngues e subconjunto de fontes), mas também funciona em inglês e outros idiomas. O diferencial é seu ciclo de aprendizado: a cada execução, a skill analisa erros, correções e feedback do usuário, propondo e aceitando lições gerais que se transformam em verificações automáticas para evitar erros recorrentes. A skill funciona em qualquer agente que possa ler e escrever arquivos, e executar comandos, exigindo o CLI `reels` instalado. O processo segue 9 etapas, desde o briefing até a renderização, com múltiplos pontos de verificação (gates) e loops de revisão, garantindo qualidade técnica e visual. Atualizações opcionais (como ElevenLabs para voz, OpenAI/Gemini para geração de imagens) são ativadas por variáveis de ambiente.

Funciona com~Claude Code✓Codex CLI~Cursor✓Antigravity✓Gemini CLI
npx skills add https://github.com/agentic-loops-x/Reels-RSI/tree/HEAD/src/reels_rsi/skill

Perguntar na sua IA favorita

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

Documentação

Reels-RSI — dirija um reel e aprenda com ele

Você é o diretor. Cada frame é uma composição HTML HyperFrames renderizada frame a frame pelo Chrome headless — código, não um modelo de vídeo. Todos os passos determinísticos são reels <comando> (no PATH; reels --help). Funciona em qualquer agente que possa ler arquivos, escrever arquivos e executar comandos; subagentes são opcionais.

Primeira execução: reels doctor — se as fontes/SFX estiverem faltando, execute reels setup. Toda execução: leia references/quality-bar.md (define o que é "pronto") e execute reels lessons digest — essas são lições de reels anteriores; siga-as. Assim que o projeto existir, reels lessons digest --project <dir> as restringe ao preset, aspecto e modo deste reel (os pacotes de frame já carregam as lições de frame restritas).

Roteiro por gênero

O usuário quer…LeiaPreset
科普/讲解 (explicar uma ideia ou processo)script-and-storyboard.mddeepspace Física/Astronomia/Tecnologia · notebook Vida/Biologia/Geografia
历史/人物/战役/朝代/文明history.mdink História da China/Poesia · atlas História mundial/Rotas · notebook Esboço rápido
题目讲解 / 知识点 / 古诗 / 笔顺solve.mdchalk Quadro negro · notebook Infantil · ink Poesia clássica
故事短片 / 故事 sem falastechniques.md, styles.mdqualquer; music: apenas, sem SCRIPT.md
"Faz igual a este vídeo"reels analyze <vídeo> primeiro, depois a linha correspondente—
> 3 mincapítulos, cada um seu próprio projeto → reels concat—
promo de produto / MV / ≤15 s motion graphic / legendas sobre cenaso fluxo HyperFrames correspondente (npx hyperframes skills); entregue em chinês com reels fonts + reels captions—

Etapa 0 — Briefing (uma rodada curta, recomendações primeiro)

Pergunte apenas o que a solicitação deixou em aberto, em uma única mensagem, cada uma com uma recomendação padrão: 题目 & 角度 (tese em uma linha) · 时长 (60–90 s; ≈ 4,5–5 caracteres/segundo) · 画幅 (16:9 B站/YouTube · 9:16 Douyin/视频号) · 风格 (preset acima, ou um visual nomeado de styles.md) · 配音 (zh-CN-YunxiNeural voz masculina animada · XiaoxiaoNeural voz feminina calorosa · YunjianNeural voz grave · en-US-AndrewNeural; ElevenLabs se ELEVENLABS_API_KEY) · 语言 (中文 · English · 日本語 · 한국어 — narração, texto na tela e legendas tudo no mesmo; reels voice detecta a partir do SCRIPT.md, vozes padrão em reels_rsi/langs.py) · 字幕 (mesmo idioma · 中英双语 · nenhum) · 音乐 (faixa do usuário em assets/music/, senão um clima) · 审阅 (sim: plano → look-dev → final). "直接做 / don't ask" ⇒ assuma todos os padrões, declare-os em uma linha, sem barreiras. Uma foto de um problema (练习册拍照) → solve.md "Problema a partir de uma foto": transcreva e reformule na etapa de plano.

Etapa 1 — Pesquisa e fatos

Verifique cada afirmação, número, data e nome (história: duas fontes para fatos contestados; resolução: calcule a resposta em código). Escreva BRIEF.md (frontmatter workflow: faceless-explainer, flow: automation, storyboard, message, destination, aspect, language, audience, length, angle, voice, style_preset; corpo ## Intent, ## Notes com fontes/cálculos).

Etapa 2 — Projeto

reels new vídeos/<slug> --preset <preset> --title "<título>" --desc "<uma linha>"

Em seguida, escreva BRIEF.md e capture/extracted/visible-text.txt (fatos) dentro dele; todo comando posterior é executado dentro do projeto. Mapas: reels geo --project . --layers countries,coastline,rivers. Imagens de época: reels commons search "…" / reels commons get --project . --name x "File:…". 笔顺: reels hanzi 字 --project ..

Etapa 3 — Roteiro e storyboard

SCRIPT.md (## Linha N — … (Frame N) + texto falado indentado; linhas **EN:** para bilíngue) e STORYBOARD.md (frontmatter format, duration, message, arc, audience, mode, music; por frame ## Frame N — título com scene, voiceover, duration, transition_in, status: outline, src: compositions/frames/NN-name.html, route, sfx, keyMessage). Detalhes: script-and-storyboard.md. Ponto de verificação: apresente tese, lista de frames (ver / ouvir / rota), duração, estilo, voz, música — aguarde.

Etapa 4 — Voz, timing, música

reels voice --project . [--voice …] [--rate +5%]

Dá voz a todas as linhas, escreve os timings das palavras em audio_meta.json, sincroniza as durações reais no storyboard, constrói a base musical nos cortes reais. Refazer a voz de um frame: --only 3.

Etapa 5 — Design visual

Escreva ## Video direction uma vez no STORYBOARD.md (funções da paleta, estilo nomeado, gramática de movimento, ritmo, lista negativa). Por frame, uma lista de tomadas com código de tempo alinhada aos tempos das palavras faladas: um movimento de câmera por frame, um herói rico (quality-bar.md). Elementos abrangentes do reel (régua de ano, barra de capítulo) → uma sobreposição (compositions/overlays/<nome>.html, history.md).

Etapa 6 — Construir frames

reels packets --project .     # .reels/packets/_role.md + um pacote por frame (incl. tempos das palavras + lições)
reels fonts --project .

6a Look-dev: construa primeiro dois frames heróis (frame 1 + o mais visual) e qualquer sobreposição; marque-os como animated; reels finalize .; olhe em snapshots/contact-sheet.jpg. Ponto de verificação: "Esse direção visual está correta?" 6b O restante: com subagentes, um por frame em paralelo — cada um recebe o caminho do projeto, seu ID de frame e os frames heróis aprovados como referência, e é instruído: leia .reels/packets/_role.md e seu pacote, escreva apenas seu frame, execute reels lint --frame <id>, responda com uma linha. Sem subagentes, construa-os você mesmo em ordem a partir dos mesmos pacotes. Marque cada um como status: animated.

Etapa 7 — Finalização e loop de revisão

reels finalize .

fontes → legendas → música → SFX → montagem → sobreposições → transições → verificação HyperFrames (lint, runtime, layout, contraste) → regras do Reels-RSI (erros que reels anteriores cometeram) → SRT → snapshots. Cada passo é registrado em .reels/. Corrija todos os erros e avisos nos arquivos de frame (nunca no índice gerado). Pontue cada frame em R1–R6 a partir da folha de contato (reels score . adiciona um juiz visual quando configurado); qualquer coisa < 4 → corrija → finalize novamente. ≥ 1 rodada, ≤ 3. Inspeção mais detalhada: reels times --project . --frame 04 → reels hf --project . snapshot --at <t>.

Etapa 8 — Renderização e entrega

reels render . --quality high
reels cover --project . --composition    # se compositions/cover.html existir
reels cover --project . --frame 08       # senão: o frame mais revelador sozinho, sem legendas

Entregue renders/video.mp4, renders/cover.jpg, renders/subtitles*.srt, CREDITS.md se houver; duração; IDs dos frames para edições; o que foi padronizado.

Etapa 9 — Aprender (sempre, leva um minuto)

  1. Registre cada observação que o espectador fez durante a execução, na íntegra: reels feedback --project . "As legendas estão muito pequenas" [--frame 04] [--approve].
  2. reels retro . — propõe lições a partir do log de execução, dos diffs de correção e do feedback, para a caixa de entrada (sem modelo de retrospectiva configurado: reels retro . --evidence-only, leia .reels/retro/evidence.md, e registre ≤ 3 lições você mesmo com reels lessons add "…" --kind doc|rule|taste --scope frame|director|history|solve). Uma boa lição é geral ("rótulos de mapa devem ficar acima de y=900 porque…"), nunca um fato sobre este tópico.
  3. Mostre a caixa de entrada (reels lessons list --state inbox) e pergunte quais manter; aceite apenas o que o espectador aprovar (reels lessons accept <id>). Uma lição do tipo rule é aceita com uma verificação funcional: reels rules new <id>, escreva rule.py + bad.html + good.html, reels rules test <id>, então reels lessons accept <id> --rule-dir ~/.reels/rules/<id>. No modo "直接做", deixe as propostas na caixa de entrada e mencione quantas estão aguardando.

Edições após a entrega

Altere apenas o que foi solicitado: cópia → SCRIPT.md + reels voice --only N + texto do frame → finalize → renderize. Visual → o HTML desse frame → finalize → renderize. Nunca reconstrua frames não modificados. Registre a solicitação com reels feedback — edições são as melhores lições.

Atualizações opcionais (ativadas automaticamente pelo ambiente)

ELEVENLABS_API_KEY → Vozes ElevenLabs [não testado] · OPENAI_API_KEY / GEMINI_API_KEY → reels image camadas de ilustração sob camadas de código [não testado] · uma faixa em assets/music/ → a base musical · um modelo juiz (reels config set roles.judge provider:model) → reels score avalia frames.

Armadilhas conhecidas (tratadas pelos comandos — não as desfaça)

Kokoro não consegue falar Mandarim → edge-tts · whisper retorna uma frase em chinês como uma única palavra → timings de palavras TTS · legendas padrão juntam palavras com espaços → reels captions · o Chrome de renderização não tem fontes CJK → reels fonts + @font-face em cada frame · o montador perde o tipo da faixa de legendas → finalize a readiciona · npm pode servir uma CLI não publicada → projetos fixam sua versão do HyperFrames.

Habilidades Relacionadas