Communitygithub.com

explicador

Transforma um clipe de entrevista ou fala num vídeo explicativo com painel do apresentador e elementos visuais de suporte, ideal para verticais (Reels/Shorts) ou horizontais (YouTube).

O que é explicador?

O skill /explainer é uma ferramenta de pós‑produção que pega um clipe de uma pessoa falando e o transforma em um vídeo explicativo profissional. O apresentador aparece em um painel arredondado com a cabeça ultrapassando a borda superior, enquanto o restante da tela exibe elementos visuais como comparações (antes/depois com seta) ou listas numeradas. Os modos de layout incluem vertical (painel em baixo, visuais em cima) e horizontal (painel de um lado, visuais ao lado). Legendas opcionais destacam palavras‑chave em pílulas coloridas. O skill é acionado pelo comando `/explainer` ou por frases como "eu embaixo, visuais em cima". Ele depende de transcrição via Groq, usa um pipeline Python e o framework HyperFrames para renderização. O processo envolve definir um trecho de 3 a 8 segundos, extrair a posição dos olhos, criar um arquivo de especificação JSON com todos os parâmetros (título, visuais, legendas) e executar o script de build para gerar o vídeo final com uma folha de verificação (sheet.jpg) que indica as áreas cobertas pela interface da plataforma.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/alisolanki/alis-claude-editing-skills/tree/HEAD/skills/explainer

Perguntar na sua IA favorita

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

Documentação

/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

  1. 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.
  2. 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 e end é o [termina …] da última frase (segundos da fonte).
  3. 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.
  4. Especificação. Escreva <nome do clipe>.explainer.json ao lado do clipe (campos abaixo). Caminhos em uma especificação são relativos ao arquivo de especificação. Cada tempo é segundos a partir de start ou uma palavra falada para ancorar ("viral", "viral#2" para sua segunda ocorrência, "viral+0.2"). Prefira palavras: elas permanecem corretas quando você move start.
  5. 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.
  6. 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 start ou end para as bordas da frase)
    • a cabeça não ultrapassar o painel (mova eye_y)
    • uma imagem estiver faltando ou deformada
  7. 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 em reveal_at.
    • O cartão direito é ou uma image simples, ou uma capa de carrossel feita de image mais text (*palavra* fica em uma pílula de destaque, \n quebra a linha).
  • 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.

Individual skills in this repo

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

Habilidades Relacionadas