Communitygithub.com

question-film

Anúncio vertical interativo para produtos que respondem perguntas: as perguntas dos usuários preenchem a tela no estilo de entrada do seu produto, cada uma se dobrando enquanto a resposta real do produto surge abaixo, fechando na entrada e no logotipo. 30 segundos, 9:16, com música.

O que é question-film?

O question-film é uma skill de agente de IA projetada para criar anúncios verticais de 30 segundos para produtos que respondem a perguntas, como assistentes, buscadores, chatbots ou sistemas de reserva. A skill adapta um filme de referência completo (Ostlery) para criar um anúncio personalizado para qualquer produto autorizado. O filme começa com o campo de entrada do produto em tela cheia, mostra perguntas do usuário que se dobram em faixas no topo enquanto as respostas reais do produto surgem abaixo, e termina voltando ao campo de entrada. A skill suporta plataformas como Reels, TikTok e Shorts, exigindo Node 20+, ffmpeg e um navegador Chrome. Ela captura telas reais do produto usando Puppeteer, adapta cores, fontes e marca, e gera um vídeo 9:16 (1080×1920) a 30 fps. As verificações integradas garantem que as quebras de linha manuais no texto não causem sobreposições de palavras durante a animação de dobra. A skill também lida com conteúdo em japonês, coreano ou chinês usando fontes Noto e respeita o idioma da página do produto.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/omnigami-ai/plugins/tree/main/plugins/omnigami-social-videos/skills/question-film

Perguntar na sua IA favorita

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

Documentação

Question film

Instruções explícitas do usuário têm prioridade sobre este fluxo de trabalho. Trabalhe apenas em produtos autorizados e dados de amostra. Não solicite senhas, chaves de API, dados de pagamento, identificadores governamentais, registros de saúde ou outros dados sensíveis. Explique dependências locais ausentes antes de instalá-las no projeto de trabalho. O acesso à rede é para os ativos licenciados do produto autorizado, além da dependência npm declarada; respeite os controles de acesso. Renderize um trabalho por vez e aguarde a conclusão. Mantenha publicação, envio e implantação fora desta tarefa.

Se várias skills puderem fazer isso: quando a solicitação não nomear esta skill e seu agente também tiver outras skills omnigami que criam o mesmo tipo de coisa (outros filmes de lançamento, tomadas, decks ou maquetes), liste-as pelo nome e pergunte qual delas o usuário deseja antes de começar. Se for nomeada, ou for a única instalada, prossiga.

Para páginas de produtos em japonês, coreano ou chinês, mantenha o texto nesse idioma e defina o lang do filme como o <html lang> da página; as fontes Noto agrupadas e as quebras de frase cuidam do texto.

Um filme vertical de 30 segundos para um produto ao qual você faz perguntas. O quadro inteiro é o campo de entrada do produto. A pergunta do usuário o preenche, grande e alinhada à esquerda, com o botão de envio do campo no canto. Enviada, a pergunta se dobra em uma faixa de título no topo e a resposta real do produto surge abaixo, de modo que cada resposta é mostrada com a pergunta que a gerou. A próxima pergunta cai sobre a resposta como uma nova faixa. Um botão real em uma resposta ("Reservar") cresce para se tornar a próxima solicitação. A última faixa se fecha de volta no campo de entrada do produto, sua linha é digitada e o filme termina no logotipo. Campos de cor sólida, uma fonte sem serifa pesada, telas reais. 30 fps em uma grade de 132 BPM, apenas vertical (1080 × 1920).

Você trabalha adaptando um filme finalizado. reference/ é o filme completo para Ostlery (um assistente fictício de reserva de estadia feito para os exemplos da omnigami; sua história está em reference/STORY.md). Mantenha seu mecanismo: a suavização, a linha do tempo, as regras de tipo, a dobra, a reabertura, a abertura do botão, o fechamento e as verificações do próprio filme. Seus substantivos se tornam os do usuário: a entrada, as perguntas, as respostas, o botão, as cores, as fontes, a linha, a marca e o nome da marca. Cada configuração que você altera é rotulada como ADAPT em reference/index.html; tudo rotulado como KEEP permanece.

Leia style.md antes de planejar e critique.md antes de julgar qualquer coisa.

O que precisa

  • O próprio produto, em execução: seu aplicativo, uma demonstração ou seu código-fonte que você possa servir. Cada tela no filme é uma captura do produto real com dados de amostra, nunca uma tela desenhada para o filme.
  • Seu campo de entrada: o campo no qual o usuário digita uma solicitação, com seu próprio botão de envio (um compositor, uma caixa de busca com um botão de ir, uma caixa de prompt). O filme abre na página que o contém e fecha de volta nele.
  • Três respostas que ele realmente dá, cada uma parte de uma tela real: uma primeira resposta a uma solicitação longa (uma lista de resultados, uma busca com suas correspondências), uma segunda que escolhe ou explica (um resultado com a resposta do produto) e uma terceira que segue um botão real na segunda resposta (uma confirmação, um estado de reservado ou enviado). Uma quarta resposta, para uma pergunta prática curta, encerra a história (direções, um detalhe, um próximo passo).
  • As palavras: a isca digitada na entrada (o próprio prompt do produto, cerca de quatro palavras, com seu nome), três solicitações que um usuário real digitaria, o rótulo do próprio botão e a linha do produto (três a seis palavras).
  • Sua marca: a marca como um SVG, o nome da marca (sua face, peso e espaçamento, ou um SVG delineado), a face da interface (arquivos com suas licenças), a cor da marca, a tinta, o fundo, um preenchimento neutro e uma cor de sucesso.

Leia o site e o aplicativo antes de perguntar; depois pergunte uma vez, em uma mensagem, pelo que eles não podem responder. Se o usuário não quiser perguntas ou uma execução não supervisionada, decida com base no que você pode acessar e diga o que decidiu.

Configuração

Verifique Node 20+, ffmpeg e um navegador da família Chrome (scripts/chrome.mjs o encontra; CHROME_PATH substitui). Explique qualquer coisa ausente e pare. Trabalhe em question-film/ no diretório atual; primeiro defina SKILL_DIR para a pasta deste arquivo:

SKILL_DIR=/caminho/para/question-film   # a pasta onde este SKILL.md está
mkdir question-film && cd question-film
cp -R "$SKILL_DIR/reference" reference && cp -R "$SKILL_DIR/reference" film && cp -R "$SKILL_DIR/scripts" scripts && cp -R "$SKILL_DIR/music" music
rm -rf reference/out film/out film/STORY.md
npm init -y >/dev/null && npm i -D 'puppeteer-core@^24'
node scripts/render.mjs reference --size 9:16 --times key --sheet --out out/reference

O filme é apenas vertical: passe --size 9:16 para cada comando render.mjs (o padrão é 16:9). reference/ permanece intocado, para comparação. Você edita film/: seu index.html e seus assets/ (as capturas do produto em assets/screens/, suas fotografias ou mídia em assets/stays/ se suas respostas mostrarem alguma, sua marca, suas fontes junto com suas licenças; exclua as da referência quando as suas carregarem). Seu STORY.md e PRODUCT.md vão no topo de question-film/. Olhe para out/reference/9x16-sheet.png agora: essa é a referência.

1. Leia o produto

  1. node scripts/capture.mjs <url> capture e leia cada captura de tela e capture/brand.json. Depois abra o produto e use-o: digite uma solicitação em sua entrada, siga a resposta, pressione o botão que a resposta oferece. Um aplicativo local: sirva-o (python3 -m http.server) e use seu endereço.
  2. Escreva PRODUCT.md: o que ele faz em uma frase, sua voz, suas fontes e licenças, sua linha, seu campo de entrada (preenchimento, raio do canto, traço, texto de placeholder, botão de envio: cor, forma, ícone, seus estados inativo e pronto), as respostas que você encontrou e o botão na segunda, e suas cores por função (os tokens do filme, C):
    • paper o fundo do aplicativo, card o preenchimento da entrada, ink seu texto, soft seu cinza de placeholder, line o traço da entrada;
    • ember a cor da marca e ember2 essa cor pressionada (os nomes são da referência; mantenha os nomes das funções);
    • sand um preenchimento neutro que o aplicativo usa (um botão inativo, um painel silenciado), rule um tom claro pressionado;
    • ok sua cor de sucesso (o campo no qual o botão abre: o resultado do botão). Cada um com onde você o encontrou e a data.

2. A história e as palavras

A história é composta por quatro solicitações e suas respostas, na ordem em que alguém realmente usa o produto:

SolicitaçãoCampoO que é
A isca (HOOK_TEXT, HOOK.text)o fundo, tipo de tinta, o nome na cor da marcao próprio prompt do produto, digitado em sua entrada: "Conte ao Ostlery a viagem."
1 (q1)a cor da marca, tipo na cor do fundoa primeira solicitação longa, do jeito que um usuário digitaria: "Um chalé no lago no fim de semana, com nosso cachorro, com orçamento limitado"
2 (q2)tinta, tipo na cor do fundouma breve continuação que pede para escolher ou explicar: "Qual é o melhor?"
3 (Q3_TEXT)a cor de sucessoo botão real na resposta 2, por seu próprio rótulo: "Reservar"
4 (q4)o preenchimento neutro, tipo de tinta, uma palavra na cor da marcauma pergunta prática curta: "Como entramos?"
A linha (LINE_TEXT)digitada na entrada real no finala linha do produto: "Planeje uma estadia em uma frase."
  • As solicitações são palavras do usuário, na voz do usuário: simples, específicas, do jeito que alguém digita para o produto. As respostas são telas reais do produto com seus dados de amostra; o filme nunca define um resultado, preço ou nome dos dados de amostra como uma afirmação.
  • Comprimentos (as verificações do filme falham além deles): solicitação 1 de seis a dez palavras (até 64 caracteres), definidas em até cinco linhas; solicitações 2 e 4 de duas a quatro palavras (até 32 caracteres), em duas ou três linhas; o rótulo do botão uma ou duas palavras curtas; a isca cerca de quatro palavras (até cerca de 26 caracteres, digitadas a 0,045 s por letra antes da caixa abrir em 3,18 s); a linha até cerca de 26 caracteres (digitada a 0,04 s por letra, concluída antes do pressionamento em 27,17 s). Cada solicitação também se dobra em um título de no máximo duas linhas com 85–120 px.
  • Quebre as linhas manualmente com / ("Um chalé / no lago / no fim de semana, / com nosso / cachorro, com / orçamento limitado"), de modo que cada linha seja uma frase e a dobra mantenha a ordem de leitura: uma palavra só pode viajar para sua própria linha ou para uma linha acima, nunca além de uma palavra que fica. A verificação do filme ("nenhuma palavra passa por outra") falha em uma quebra que faça as palavras se cruzarem na dobra; requebre a solicitação, nunca a verificação.
  • Uma palavra da solicitação 4 pode ser marcada *assim* para ser definida na cor da marca (a referência marca "entrar?"). A palavra-chave da isca (o nome do produto) é marcada da mesma forma em HOOK.text.

Escreva STORY.md no formato de reference/STORY.md: o resumo, o que cada batida diz, a folha de batidas com sua entrada, respostas, botão e campos, e cada palavra com sua fonte. Mostre ao usuário as solicitações, as respostas que você capturará e o botão em algumas linhas e peça uma revisão, a menos que ele tenha solicitado uma execução não supervisionada. Nunca considere o silêncio como aprovação.

3. Capture as telas reais

Escreva um plano para scripts/screens.mjs (o formato está no topo do script) em um viewport de telefone de 390 × 844 e execute-o em film/assets/screens/ (node scripts/screens.mjs plan.json film/assets/screens). O filme desenha capturas pelo nome a partir de screens.json, então mantenha os nomes da referência:

NomeO quePassos
homea página que contém a entrada, viewport inteiro, escala 3capture com full
composera entrada vazia, escala 4capture around a entrada
ask-01 … ask-NNa isca digitada letra por letratype na entrada com capture: "ask", around a entrada
line-01 … line-NNa linha digitada da mesma formatype com capture: "line"
searcho painel principal da resposta 1 (a referência: o cartão de busca)capture around ele após enviar a solicitação 1
a2resposta 2: o resultado escolhido, a resposta e seus botões, como um painelcapture around a resposta
a3resposta 3: o estado para o qual o botão leva (Reservado, seu cartão)pressione o botão, depois capture
trip-infoo painel da resposta 4 (a referência: as linhas de Dirigir e Entrar da página da viagem)capture around ele

Registre o retângulo da entrada (rects) para que COMP, TXT e SEND correspondam a ele: COMP é a caixa da entrada em px CSS (x, y, w, h, seu raio), TXT seu recuo esquerdo do texto, tamanho e primeira linha de base, SEND o centro e raio do botão de envio dentro dele. Antes de capturar, verifique se seus rótulos estão centralizados: node scripts/centring.mjs plan.json, e relate o que listar. As respostas que mostram fotografias (as seis estadias da referência, o chalé e seu quarto) usam as imagens próprias do produto em assets/stays/ (STAYS, FOCUS); uma resposta sem fotografias sobe apenas como painéis capturados.

4. Adapte film/index.html

  • Tokens e faces (C, SANS, SERIF): as cores da marca por função (passo 1). SANS é a face da interface, definida em 880 para cada solicitação e título: uma face variável com uma extremidade pesada (a Figtree da referência vai de 300 a 900); uma face sem uma: seu peso mais pesado, e diga isso. SERIF é a face do nome da marca. Carregue ambos em prepare().
  • A marca e os ícones (MARK, ICON_UP, ICON_CHECK): os dados do caminho do SVG copiados exatamente (dimensionados para a caixa de 100 unidades se seu viewBox for diferente); os ícones de envio e verificação do próprio aplicativo, copiados exatamente.
  • As solicitações (HOOK, REQ, defaults(), fields, Q3_TEXT): as palavras do passo 2; o campo de cada solicitação, tipo, acento e cores do botão de envio (bg, ink, acc, btn, arrow, dark para seu pressionamento); bh, a altura de cada faixa (a primeira, duas linhas, 440; as restantes 330).
  • As respostas (answer1 … answer4, A1 … A4, A2_ROWS, A2_PILL, A3, PILL): as capturas do produto, em 2,6–2,7× seu tamanho CSS (uma página de telefone de 390 px na largura do quadro é 2,77×), centralizadas sob a faixa. Mantenha como chegam (KEEP): cada parte sobe de baixo para o espaço que a faixa deixa, escalonadas (fotos 0,06 s de intervalo, da esquerda para a direita e linha por linha; linhas de uma resposta 0,045 s de intervalo), em EXPO_OUT, nunca um fade ou deslize lateral (o carrossel da resposta 2 desliza da direita para dentro de seu painel, porque o carrossel do produto rola dessa forma). Meça o botão na captura a2 em A2_PILL (seu rect CSS) e redesenhá-lo da maneira do aplicativo em drawPill, para que possa ser pressionado e crescido.
  • Mudança de estado da resposta 3 (bookPill, T.booked, T.done): o estado de processamento do próprio produto, depois seu estado concluído, um rótulo de cada vez, depois o painel concluído capturado. Se o produto não mostrar estado de progresso, pule essa etapa e suba o painel concluído em T.booked.
  • O logotipo (LOCK, endLock, sceneEnd, prepare's MW): mantenha as proporções (o tamanho do nome da marca 124:98,6 da altura desenhada da marca, a lacuna 26:98,6, a linha de base no pé da marca, a marca um pouco acima do meio: o filme as verifica). A palavra, sua face e peso são da marca; seu espaçamento é o da marca (a referência define o de Ostlery como −0,0174 em, como outros filmes dela fazem: um nome de marca definido mais solto do que a marca define foi devolvido). Um nome de marca delineado: desenhe seu caminho em vez de fillText.
  • KEEP: as curvas de suavização, T (altere um tempo apenas com seus vizinhos, style.md), MARGIN, TRACK, LEAD, WT, o layout e suas quebras, foldK, flipWord, riseWord, a dobra, a reabertura, a abertura do botão, a íris, o fechamento, as deixa e selfChecks.

As regras que o fundador definiu para a dobra (todas KEEP; as verificações do filme mantêm as quatro primeiras)

  1. As palavras deslizam primeiro e sobem apenas quando a faixa surge. foldK: transversalmente (com o tamanho) a partir do pressionamento em 70% do movimento; a subida espera 0,3 s, até que a faixa tenha subido perto sob as palavras, então pousa com ela.
  2. Uma escala compartilhada. Cada palavra de uma solicitação em um progresso, uma curva, um início: sem escalonamento por palavra ou por linha na dobra, de modo que todas as palavras tenham o mesmo tamanho em cada quadro.
  3. Cada palavra troca de lugar com as que estão abaixo. As palavras deslizam para cima e para baixo umas pelas outras (como um filete em um ábaco) sem empurrar; a dobra mais alta (a última a pousar) pode subir um pouco acima da faixa enquanto as palavras abaixo ainda estão se movendo; a verificação as mantém ordenadas.
  4. A dobra nunca para em uma posição onde uma palavra obscurece outra. A verificação garante que, quando o movimento para, todas as palavras estejam dentro de seus limites de linha designados.
  5. A primeira e a última palavra da linha superior são ancoradas aos cantos. A primeira palavra da linha superior nunca se move para a direita de sua posição inicial; a última nunca se move para a esquerda; as palavras internas podem deslizar para caber.

A abertura do botão (KEEP, menos a cor e o rótulo, que são ADAPT)

O botão cresce uniformemente para preencher o quadro. Seu centro permanece fixo; suas bordas esquerda, direita, superior e inferior se expandem na mesma proporção a partir daí — como uma flor em time-lapse. Ele nunca se estica ou distorce. O ícone (o checkmark) aparece apenas quando o botão está totalmente crescido.

A íris (KEEP)

Um círculo cobre o quadro vindo do botão de envio. Seu centro é o centro do ícone de envio; ele cresce em EXPO_OUT para revelar a tela do produto por baixo. O círculo é a cor do fundo do produto.

5. Renderize e verifique

node scripts/render.mjs film --size 9:16 --times key --out out/film

Verifique com reference/out/reference/9x16-sheet.png contra film/out/film/9x16-sheet.png: as verificações integradas em cada cena comparam os tempos, a ordem de leitura da dobra, o dimensionamento e a proporção. Se uma verificação falhar, leia o relatório, corrija e renderize novamente. O filme finalizado é uma pasta com 9x16.mp4, 9x16-poster.jpg e 9x16-sheet.png.

Individual skills in this repo

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

Habilidades Relacionadas