Communitygithub.com

MiguelBai/yanni-video-editor

Edita vídeos de Yanni (talking head) no estilo "paper cut" de reels científicos: rosto na câmera misturado com cenas de papel amassado, objetos recortados caindo, páginas de estudo passando, números estatísticos em vermelho e legendas palavra por palavra.

O que é yanni-video-editor?

Este skill transforma vídeos crus de Yanni (criador de conteúdo sobre nutrição, peptídeos e físico) em reels 1080x1920 finalizados no estilo "paper cut" — um formato de divulgação científica que intercala o rosto do apresentador com cenas explicativas em papel amassado. Ele automatiza todo o fluxo: corte de silêncio e erros de gravação, transcrição, planejamento de beats (alternando entre cenas de rosto e papel), busca e recorte de imagens de objetos e estudos, construção de composições com a ferramenta HyperFrames, pré-visualização, renderização com revisões. O skill é ativado sempre que o usuário arrasta um arquivo de vídeo ou envia comandos como "edit this", "edit my video", "make the reel" ou "cut this". Ele trabalha de forma autônoma, mantendo as mensagens para o usuário curtas e objetivas, e só interrompe para pedir algo essencial (como links de estudos ou informações faltantes). Segue regras rígidas contra fabricação de evidências — usa apenas estudos reais e números ditados pelo apresentador. A saída final é um vídeo com legendas sincronizadas, objetos recortados e animados, páginas de estudo capturadas de fontes como Europe PMC, e um esquema de cores com um único tom de destaque (definido no brand.json). O skill suporta revisões iterativas: o usuário pode pedir ajustes, que são feitos editando o build/edit.json e re-renderizando.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MiguelBai/yanni-video-editor/tree/HEAD/skills/edit

Perguntar na sua IA favorita

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

Documentação

Editor de reels no estilo paper cut

Yanni é um criador de conteúdo sobre nutrição, peptídeos e físico. Ele se grava falando. Este skill transforma a gravação bruta em um reel 1080x1920 finalizado no estilo do referencial que ele escolheu (um explicador de farmacologia): seu rosto na câmera, intercalado com cenas explicativas em papel amassado, legendas sobre tudo.

O usuário mal usa o Claude. Faça todo o trabalho você mesmo, mantenha as mensagens curtas e diretas, e só pare para perguntar quando realmente precisar de algo dele (um link de estudo, um vídeo faltando). Nunca mostre JSON bruto ou logs longos para ele.

Leia references/style.md uma vez antes do seu primeiro plano. É a bíblia do estilo medido; este arquivo é o procedimento.

E abaixo significa <diretório base deste skill>/engine.

0. Pré-voo

  • ~/.yanni-editor/brand.json faltando, ou ffmpeg/whisper-cli/node faltando: execute o skill de configuração primeiro, depois volte.
  • Encontre o vídeo. Se ele arrastou um arquivo, o caminho está na mensagem. Se não, pergunte uma vez: "Arraste o arquivo de vídeo para esta janela e pressione Enter."
  • Pasta do projeto: <projectsDir de brand.json>/<tópico-em-kebab-case> (por exemplo, ~/Movies/Yanni Edits/bpc-157-healing). Escolha o slug depois que a transcrição revelar o tópico; use untitled-<data> até lá e renomeie depois.

1. Preparação e transcrição

node "$E/prep.mjs" "<vídeo bruto>" "<projeto>"

Normaliza para 1080x1920 30fps a -16 LUFS e escreve build/raw.transcript.txt (frases com timestamps). Leia esse arquivo.

2. Corte de cortes (e takes ruins)

Procure por retakes: a mesma frase dita duas vezes, um falso começo, "espera deixa eu refazer isso". Mantenha o ÚLTIMO take, remova os anteriores pelo intervalo de tempo bruto. Remova também lixo claro no início e no final (ele alcançando o telefone).

node "$E/cut.mjs" "<projeto>" --remove "3.10-7.85,40.2-44.0"
# sem retakes: node "$E/cut.mjs" "<projeto>"

Pausas são cortadas do próprio áudio (qualquer coisa mais silenciosa que -35 dB por 0,3s ou mais). Se ele parecer apressado, use --gap 0.45; se a sala estiver barulhenta e nada for cortado, tente --db -30. Saída: build/head.mp4 e build/transcript.txt no tempo cortado. Todos os tempos de beats daqui em diante são tempos cortados.

Leia build/transcript.txt. O Whisper erra nomes; escreva as correções em replace no edit.json (um mapa palavra por palavra, case insensitive), por exemplo, {"BPC157": "BPC-157", "tren": "Tren"}.

3. Planeje os beats (escreva antes de tocar nos assets)

Escreva build/plan.md: uma linha por beat com intervalo de tempo cortado, a linha falada, FACE ou PAPER, e para paper o que está na tela. Regras do referencial:

  • Abrir em PAPER. Os primeiros 2 a 4 segundos são uma cena de papel com uma tag de cabeçalho preta nomeando o tópico e o objeto principal caindo. Isso é o gancho.
  • O primeiro beat FACE carrega o carimbo de nome ("stamp": 0.2).
  • Alterne. Nunca dois beats de paper consecutivos sem face entre eles, a menos que o pensamento falado claramente continue (então faça um único beat de paper com várias tomadas). Beats de paper de 2 a 5 s, beats de face de 1,5 a 5 s. Mire em paper em 45 a 55 por cento do tempo de execução. build.mjs imprime paperShare.
  • O que vai no papel: o momento em que ele nomeia um composto, comida, suplemento, parte do corpo ou estudo; diz um número; descreve um mecanismo. O que fica na face: opiniões, avisos, conclusões, piadas, a chamada para ação. A face é a confiança; o papel é a prova.
  • Dentro de um beat de paper a tomada muda a cada 1,2 a 2,5 s. whip para a próxima página de estudo, push para adicionar a estatística ou figura sob o card atual, zoom para trocar objetos. Um beat de paper com uma tomada estática por 4 s é morto.
  • Trecho longo de face (mais de ~4 s com um corte interno): divida-o em dois beats de face e dê ao segundo "zoom": 1.12 (um zoom-in esconde o corte).

4. Reúna os visuais

Coloque tudo em build/assets/. Escreva build/assets/credits.txt com a fonte de cada imagem (find_images imprime licença e página).

Objetos recortados (frasco, seringa, peito de frango, ovo, haltere, cérebro, fígado):

node "$E/find_images.mjs" "seringa" "<projeto>/build/cand" --n 6
# OLHE os candidatos (Leia-os), escolha o objeto mais claro em um fundo simples
node "$E/cutout.mjs" "<projeto>/build/cand/seringa-2.jpg" "<projeto>/build/assets/seringa.png"

Depois OLHE o recorte. A remoção de fundo falha em vidro, plástico transparente e fundos complexos. Se falhar, tente outro candidato, ou use a foto como um card em vez de um cutout. Anatomia fica melhor como gravuras antigas: pesquise "Anatomia de Gray <órgão>" e use "mono": true para o visual em escala de cinza que o referencial usa. Se ele tiver suas próprias fotos de produto, prefira essas.

Páginas de estudo (a espinha dorsal deste estilo):

  • Apenas estudos REAIS. Peça a ele o link se ele citar um e você não conseguir encontrá-lo com certeza. Nunca invente um estudo, uma página de periódico, uma figura ou um número. Alegações de saúde em uma captura de tela falsa podem prejudicar pessoas e a conta dele.
  • Captura de tela via Europe PMC (PubMed bloqueia navegadores headless):
    node "$E/webshot.mjs" "https://europepmc.org/article/MED/<PMID>" "<projeto>/build/cand/study.png"
    
    OLHE. Depois recorte a parte que ele está falando: o bloco de título para "um estudo de 2017 de Oslo...", a frase exata do resultado ou figura para a alegação:
    ffmpeg -v error -y -i study.png -vf "crop=W:H:X:Y" -frames:v 1 "<projeto>/build/assets/study-title.png"
    
    A captura de tela está em escala 2x, então os recortes são nítidos. Mantenha os cards legíveis: recorte próximo, um card tem no máximo ~820 px de largura na tela.
  • Páginas de periódicos (ScienceDirect, Wiley) frequentemente bloqueiam também. Se a captura for um captcha ou em branco, peça a ele para capturar a tela da página no Mac (Cmd+Shift+4) e soltar o arquivo.

Números estatísticos (stat): apenas números que ele diz em voz alta, palavra por palavra.

5. Escreva build/edit.json e construa

Formato completo e todas as opções: references/edit-json.md. Estrutura mínima:

{
  "title": "bpc-157 healing",
  "video": "head.mp4",
  "transcript": "transcript.json",
  "replace": { "bpc157": "BPC-157" },
  "beats": [
    { "type": "paper", "start": 0, "end": 3.2, "header": "Does BPC-157 Heal Tendons?",
      "shots": [
        { "at": 0, "enter": "drop", "items": [ { "kind": "cutout", "src": "assets/vial.png", "label": "BPC-157" } ] },
        { "at": 1.6, "enter": "zoom", "items": [ { "kind": "cutout", "src": "assets/tendon.png", "mono": true } ] }
      ] },
    { "type": "face", "start": 3.2, "end": 6.4, "stamp": 0.2 },
    { "type": "paper", "start": 6.4, "end": 10.1,
      "shots": [
        { "at": 0, "enter": "cut", "items": [ { "kind": "card", "src": "assets/study-title.png" } ] },
        { "at": 1.8, "enter": "push", "items": [ { "kind": "stat", "text": "40 rats", "enter": "pop" } ] },
        { "at": 2.7, "enter": "whip", "items": [ { "kind": "card", "src": "assets/study-result.png" } ] }
      ] }
  ]
}

Qualquer coisa não coberta por um beat de paper mostra o rosto dele. Então:

node "$E/build.mjs" "<projeto>/build/edit.json"
cd "<projeto>/build" && npx -y hyperframes@latest check

check deve dizer Check passed. Avisos sobre sub-composições, densidade de trilhas e imagens duplicadas são esperados para este formato; erros não.

6. Olhe antes de mostrar a ele

cd "<projeto>/build" && npx -y hyperframes@latest snapshot --at <um tempo dentro de cada beat>

Leia snapshots/contact-sheet-*.jpg. Verifique: cada beat de paper tem algo nele, nada sobrepõe as legendas, cards estão legíveis, recortes têm bordas limpas, o carimbo está no primeiro beat de face dele, as legendas estão escritas corretamente. Corrija e reconstrua até estar certo. Ele nunca deve ser o primeiro a encontrar um quadro quebrado.

7. Pré-visualização e renderização

Renderize um rascunho para que ele possa assistir no celular ou Mac:

cd "<projeto>/build" && npx -y hyperframes@latest render --quality draft --output "../out/<slug>-draft.mp4"
open "<projeto>/out"

Diga a ele em duas linhas: onde o arquivo está, e "me diga qualquer coisa que você queira mudar, como 'aumente o estudo em 0:12' ou 'mais rosto no meio'."

Para mudanças: edite build/edit.json, reconstrua, verifique, tire snapshot, renderize novamente. Para a versão final:

npx -y hyperframes@latest render --quality high --output "../out/<slug>.mp4"

Verifique se o arquivo existe, reproduz, e sua duração corresponde a build/head.mp4 (ffprobe -v error -show_entries format=duration -of csv=p=0 <arquivo>). Acima de ~60 MB, re-codifique para upload: ffmpeg -i in.mp4 -c:v libx264 -crf 21 -preset slow -c:a copy out.mp4.

Se ele quiser ajustar coisas manualmente, npx -y hyperframes@latest preview na pasta build abre o HyperFrames Studio no navegador com toda a linha do tempo.

Regras rígidas

  1. Nunca fabrique evidências. Sem estudos, números, figuras, citações ou imagens de antes/depois inventados. Se o áudio afirmar algo que você não consegue referenciar, mantenha essa linha no rosto dele e diga a ele qual linha precisa de uma fonte.
  2. Legendas correspondem ao que ele DISSE, não ao que o roteiro dizia. Corrija apenas a ortografia.
  3. Uma cor de destaque, do brand.json. Texto estatístico em vermelho, linha do carimbo vermelha, nada mais colorido exceto as próprias imagens.
  4. Não reestilize o sistema por vídeo. Fontes, papel, aparência das legendas e movimento ficam em engine/runtime/. Um vídeo recebe seu próprio edit.json, nunca seu próprio CSS. Se ele pedir uma mudança de estilo global, mude o runtime uma vez.
  5. O tempo é o tempo cortado, de build/transcript.txt, nunca o tempo bruto.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas