/explainer
┌──────────────────────┐
│ Roube o que funciona│ título, uma palavra no tom de destaque
│ [antes] ⟶ [depois] │ comparar: cartão, seta desenhada, revelação (ou uma lista numerada)
│ ╭──cabeça──╮ │ a cabeça ultrapassa o painel
│ ╭────┴──────────┴────╮ │
│ │ apresentador, legendas│ │ painel arredondado, linha dos olhos = borda superior
│ ╰────────────────────╯ │
└────────────────────────┘
Primeiro uso
A pasta deste skill é o "Diretório base" que o Claude Code mostra ao carregá‑lo. Resolva o kit a partir dela (funciona via symlinks) e configure uma vez:
SKILL_DIR="<diretório base deste skill>" # o caminho que o Claude Code exibiu como "Base directory for this skill"
KIT=$(python3 -c 'import os,sys;print(os.path.realpath(os.path.join(sys.argv[1],"..","..","kit")))' "$SKILL_DIR")
PY="$KIT/.venv/bin/python"; [ -x "$PY" ] || bash "$KIT/setup.sh" --cutout
A variável GROQ_API_KEY deve estar definida para transcrição (gratuita em console.groq.com). São necessários ffmpeg e Node.
Formato
Toda especificação aceita "format": "vertical" (1080×1920: Reels, Shorts, vídeos verticais longos), "horizontal" (1920×1080: YouTube e outros formatos longos) ou "auto" (padrão: segue a proporção da fonte). Execute "$PY" "$KIT/reel.py" probe <video> para ver o que o modo automático escolhe. A folha de verificação pinta de vermelho o que a interface da plataforma cobre: a UI do Instagram/TikTok no vertical, o player do YouTube no horizontal. Para vídeos completos, use este skill como um momento dentro de /long-form em vez de cortar o clipe manualmente.
Etapas
- Clipe. Use o clipe fornecido pelo usuário (qualquer tamanho; será cortado para 1080×1920 ou 1920×1080, veja Formato). Peça‑o apenas se nenhum tiver sido dado.
- Palavras.
"$PY" "$KIT/reel.py" words <video>imprime cada palavra com seu tempo (transcreve no primeiro uso). Imprime uma frase por linha com[termina …], o tempo em que sua última palavra termina. Escolha um trecho de 3 a 8 segundos que transmita UM ponto, composto de frases completas:starté o tempo da primeira palavra eendé o[termina …]da última frase (segundos da fonte). - Linha dos olhos.
"$PY" "$KIT/reel.py" frame <video> <um tempo no trecho> frame.jpg, depois examine a imagem. As réguas estão em pixels do canvas; leia o y dos olhos. Esse éeye_y(vertical: aproximadamente 700 a 800 para um enquadramento normal; horizontal: aproximadamente 350 a 450). No horizontal, leia também o x do centro do rosto: esse éface_x. - Especificação. Escreva
<nome do clipe>.explainer.jsonao lado do clipe (campos abaixo). Caminhos em uma especificação são relativos ao arquivo de especificação. Cada tempo é segundos a partir destartou uma palavra falada para ancorar ("viral","viral#2"para sua segunda ocorrência,"viral+0.2"). Prefira palavras: elas permanecem corretas quando você movestart. - Build.
"$PY" "$SKILL_DIR/build.py" <spec.json>. Ele corta o trecho, extrai o apresentador (aproximadamente 0,1 s por quadro), renderiza com HyperFrames e escreve<out>.sheet.jpg. - Verificação. Examine a folha. O vermelho é o que a plataforma cobre. Corrija a especificação e reconstrua se:
- o título ou os visuais estiverem na área vermelha
- uma legenda cobrir a boca ou estiver a menos de 80 px da zona vermelha inferior (mova
caption_top) - uma legenda mostrar uma palavra de fora do trecho (mova
startouendpara as bordas da frase) - a cabeça não ultrapassar o painel (mova
eye_y) - uma imagem estiver faltando ou deformada
- Entrega o caminho do mp4 e diga em uma linha o que cada visual mostra.
Especificação
{
"video": "meu-clipe.mp4", "start": 21.4, "end": 25.66, "out": "meu-clipe.apresentador.mp4",
"title": "Roube o que *funciona*",
"eye_y": 750,
"visual": {
"type": "compare",
"left": {"label": "Outro nicho", "images": ["deles-1.jpg", "deles-2.jpg", "deles-3.jpg"], "at": 0.3,
"chip": "14× viral", "chip_at": "viral", "swipe_at": ["carrossel", 2.3]},
"right": {"label": "Seu nicho", "at": "fora", "reveal_at": "recriar",
"image": "minha-foto.jpg", "text": "as melhores *ferramentas de ia*\npara usar quando\nvocê é *jovem e liso*"},
"arrow_at": "e"
},
"keys": ["viral", "fora", "recriar"],
"caption_top": 1420
}
title: 1 a 4 palavras. Coloque UMA palavra entre*...*para a cor de destaque.visual.type: "compare"é um antes e depois:- O cartão esquerdo mostra 1 a 3 imagens e desliza entre elas em
swipe_at. - O cartão direito começa como um "?" tracejado. A seta desenha em
arrow_at, então o cartão revela emreveal_at. - O cartão direito é ou uma
imagesimples, ou uma capa de carrossel feita deimagemaistext(*palavra*fica em uma pílula de destaque,\nquebra a linha).
- O cartão esquerdo mostra 1 a 3 imagens e desliza entre elas em
- Qualquer cartão pode ser um cartão de texto em vez de imagens:
"big": "*Pro*\nferramentas", "small": "o que os profissionais usam". Use quando o usuário não tiver imagens. É a escolha certa para uma comparação esquerda/direita que o apresentador aponta. visual.type: "list":{"type": "list", "items": [{"text": "Encontre um post *viral*", "at": "encontrar"}, ...]}. Até 4 linhas numeradas, cada uma aparecendo quando for dita.keys: palavras‑chave para colocar na pílula de destaque. Escolha 2 a 4 que carreguem o significado. Cada vez que a palavra é dita, ela é destacada.- Apenas no modo horizontal:
face_x(centraliza o rosto no painel),side("right"padrão, ou"left"),scale(0,9: o tamanho do apresentador). caption_top: o y do topo das legendas: 1420 no vertical (mantenha a parte inferior acima de 1500), 850 no horizontal (fica sobre o painel; mantenha a parte inferior acima de 960).
Bom gosto
- Um ponto por clipe. Se o trecho contiver dois pontos, faça dois explicadores.
- Posicione cada visual na palavra que o nomeia. Nada deve aparecer antes de ser dito. O título é a exceção: ele está lá desde o primeiro quadro.
- No vertical: mantenha os visuais do topo entre y 330 e 760 (o título fica acima deles, aproximadamente em y 210). No horizontal: o título fica em y 110, os visuais entre y 270 e 830 ao lado do painel. Texto e gráficos devem ficar fora das zonas vermelhas; o painel do apresentador pode invadi‑las.
- Se o apresentador apontar para a esquerda e para a direita, use
compare. Seus cartões ficam onde ele aponta. - Use as próprias imagens do usuário. Nunca invente números ou resultados sobre a postagem de outra pessoa. Uma etiqueta como "14× viral" deve ser algo que o usuário disse ou forneceu.