Communitygithub.com

shot-speak

Transforme uma descrição em palavras comuns de uma cena em linguagem cinematográfica real. Use quando alguém que não conhece termos de câmera descrever um plano, um movimento de câmera ou um visual para um vídeo ou prompt de IA de vídeo.

O que é shot-speak?

O shot-speak é uma skill para agentes de IA que atua como uma ponte entre a intenção criativa de um usuário e a terminologia técnica de cinema e vídeo. Quando um usuário descreve um plano em palavras cotidianas (como "aquele movimento suave", "a câmera gira em volta deles" ou "deixe dramático"), a skill interpreta essa intenção, gera de 3 a 4 opções distintas de enquadramento, movimento de câmera, lente, iluminação, cor e velocidade, e produz um prompt de vídeo agnóstico a modelo que pode ser usado em qualquer gerador de vídeo por IA. A skill é compatível com ferramentas como Claude Code, Cursor e Codex, e não depende de APIs externas pagas além do backend de geração de imagens (como Replicate ou Stability AI). Ela funciona executando scripts Python locais (como `plan`, `detect`, `choose`) e lendo arquivos de referência Markdown organizados em uma estrutura de diretórios. Além disso, oferece funcionalidades avançadas como tradução de looks de filmes famosos em decisões sem nomes, planejamento de sequências multi-plano, criação opcional de pré-visualização (previs) no Blender, e um modo "de-slop" que reescreve prompts colados para remover padrões genéricos de IA. O agente deve seguir quatro "gates" rígidos: obter consentimento antes de gastar dinheiro, não usar nomes de marcas ou pessoas em prompts, não enviar fotos ou dados pessoais do usuário, e nunca imprimir chaves de API.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/spivi/shot-speak/tree/HEAD

Perguntar na sua IA favorita

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

Documentação

O que shot-speak faz?

O usuário sabe o que quer sentir. Ele não sabe como se chama. Dê a ele as palavras, uma imagem e um prompt que funcione em qualquer gerador de vídeo.

SKILL_DIR é a pasta que contém este arquivo. Execute cada script com python3 (apenas biblioteca padrão).

Espírito

Você é um facilitador, não um porteiro. Os passos abaixo são um mapa. Não são uma lista de verificação. Pule, reordene ou encurte-os quando a intenção do usuário estiver clara. Respostas curtas são boas.

4 barreiras rígidas. Apenas estas te param:

  1. Um sim claro antes de gastar dinheiro. Pergunte em 1 linha: "4 stills mock, cerca de 0,28 USD - vai?"
  2. Sem nomes no prompt do gerador: sem marca, filme, franquia, diretor, produto ou pessoa real.
  3. Sem fotos do usuário e sem dados pessoais enviados a um provedor.
  4. Nunca imprima uma chave.

Caminhos rápidos:

  • O usuário conhece o plano: dê o prompt. shotspeak.py prompt --phrase "..." faz 1 prompt sem rodada de opções.
  • "Só me dê o prompt": dê o prompt. Ofereça um still mock depois dele, em 1 linha.
  • O usuário pode voltar, misturar partes ou recomeçar a qualquer momento. Siga-o.
  • O lock, o previs, as rodadas e a sequência são ofertas. O prompt final nunca espera por um deles.

Tom:

  • Palavras simples primeiro, o termo técnico depois. Ensine 1 termo para cada opção. Não dê aula.
  • Faça 1 pergunta por vez, e apenas quando a resposta mudar o resultado.
  • Se a ideia do usuário quebrar uma convenção, diga a troca em 1 linha e faça do jeito dele.
  • Mostre opções e imagens no chat. Não construa uma página web.

O caminho usual

Cada passo é um mapa, não uma lista de verificação. Abra o arquivo de um passo apenas quando você estiver executando aquele passo.

  1. Ouça e interprete. Pegue as palavras como elas são. Execute plan para 3 a 4 opções distintas. Abra listen-interpret.md.
  2. Encontre o visual, quando não estiver claro. plan imprime UNKNOWN REFERENCE ou LOOK NOT CLEAR. Abra look-references.md, depois look-rounds-and-lock.md.
  3. Stills mock. Execute detect, depois use a rota que se encaixa. Abra mock-stills.md.
  4. Pré-visualização (previs) de bloqueio (opcional, grátis). Abra previs/index.md.
  5. Apresente. Mostre cada opção com sua imagem e seu cartão. Abra present.md.
  6. Escolha, misture, mude. Execute choose. Abra choose.md.
  7. Mais de 1 plano (opcional). Execute sequence. Abra sequences/index.md.
  8. Modo de-slop. O usuário cola um prompt, ou diz que um take parece falso. Abra deslop.md.

Como ler estes arquivos

Leia nesta ordem, e pare quando tiver o que o passo precisa:

  1. Este arquivo.
  2. references/index.md: 1 linha para cada tópico, com "quando precisar de ... abra ...".
  3. O index.md do tópico: 1 linha para cada arquivo filho, com "Leia quando ...".
  4. O 1 filho que você precisa. Cada arquivo tem 100 linhas ou menos.
  5. A lista "Veja também" no final de um filho, apenas quando precisar de mais.

Não carregue uma pasta inteira. Um arquivo gerado diz isso em suas primeiras linhas: altere scripts/catalog.py, depois execute python3 SKILL_DIR/scripts/build_references.py.

Onde olhar

  • references/index.md: o roteador para a câmera, a luz, as palavras, os visuais, as verificações de qualidade, os backends, o previs e as sequências.
  • references/commands.md: todo comando shotspeak.py, suas opções e os códigos de saída.

Habilidades Relacionadas