Habilidade de Vídeo Curto

Vídeos curtos (≤ 10s) são o ponto ideal para os modelos atuais de texto para vídeo — eles são ótimos em um plano com uma ideia, mais fracos em narrativas com múltiplos cortes. Planeje um plano por chamada.

Caso especial: hyperframes-html não é um modelo de texto para vídeo fotorrealista. É um renderizador local de HTML para MP4. Para esse modelo, não interprete cinematografia ou física de câmera do "mundo real". Trate o briefing como um cartão de motion design / quadro de título / interstitial de produto, faça no máximo uma pergunta esclarecedora e, em seguida, envie imediatamente.

Mapa de Recursos

video-shortform/
├── SKILL.md
└── example.html

Fluxo de Trabalho

Passo 0 — Ler os metadados do projeto

videoModel, videoLength (segundos), videoAspect. Estes são limites rígidos — ajuste o prompt ao que o modelo escolhido suporta (Seedance 2 limita a 10s; Kling 4 suporta até 10s + imagem para vídeo; Veo 3 suporta 8s com áudio).

Passo 1 — Planejar o plano

Escreva a lista de planos ANTES de chamar o modelo:

Normalmente, mostre isso ao usuário como um plano de uma frase antes de enviar — eles podem redirecionar de forma barata.

Para hyperframes-html, pule a narração extra pré-envio assim que o usuário responder ao formulário de descoberta. Colapse o plano no prompt de geração real e envie imediatamente.

Passo 2 — Compor o prompt

Use o formato que o modelo upstream prefere (Seedance: movimento + câmera + humor; Kling: assunto + câmera + estilo; Veo: assunto + cinematografia + som). Vincule diretamente o videoAspect e o videoLength do projeto aos parâmetros da API; nunca os coloque em prosa.

Para hyperframes-html, escreva um breve briefing de motion design em vez de um prompt de realismo de câmera. Concentre-se no assunto, layout, paleta, caráter do movimento e tom geral. Não gaste turnos narrando verificações de ambiente, arquivos laterais ausentes ou atualizações de status de "estou prestes a enviar".

Passo 3 — Enviar via contrato de mídia

Use o dispatcher unificado — não chame as APIs do provedor manualmente:

"$OD_NODE_BIN" "$OD_BIN" media generate \
  --project "$OD_PROJECT_ID" \
  --surface video \
  --model "<videoModel from metadata>" \
  --aspect "<videoAspect from metadata>" \
  --length <videoLength seconds> \
  --output "<short-slug>-<seconds>s.mp4" \
  --prompt "<assembled shot prompt from Step 2>"

O comando imprime uma linha de JSON: {"file": {"name": "...", ...}}. Os bytes são armazenados no projeto; o FileViewer os reproduz automaticamente.

Passo 4 — Entregar

Responda com: resumo do plano, o nome do arquivo retornado pelo dispatcher e uma frase sobre o que tentar se o usuário quiser uma variação.

Para hyperframes-html, mantenha a resposta especialmente curta: o que foi renderizado, o nome do arquivo e uma ideia concreta de variação.

Regras rígidas

• Um plano por turno. Linhas do tempo com múltiplos planos pertencem a uma habilidade de hyperframes / vídeo interativo, não aqui.
• Combine o videoAspect exatamente — re-renderizações são lentas.
• Nunca envie um vídeo sem salvar o arquivo — o usuário espera algo para reproduzir no visualizador de arquivos.
• Quando o modelo subjacente falhar (filtro NSFW, política de conteúdo, tempo limite), mantenha o erro bruto do provedor no rastreamento da ferramenta e dê ao usuário a frase nextStep do contrato de mídia para esse resultado. Nunca cole o texto do erro upstream na resposta. Não tente novamente silenciosamente.
• Não afirme que uma renderização foi "enviada", "iniciada" ou "está em execução" a menos que você já tenha chamado "$OD_NODE_BIN" "$OD_BIN" media generate.