script-ads-validados-wisky
v1.2.3
Published
Instalador licenciado da biblioteca Script Ads Validados Wisky para Codex, Claude Code e Google Antigravity
Maintainers
Readme
Script Ads Validados Wisky
Biblioteca privada de modelos de criativos validados para alunos da mentoria de low ticket de Lucas Wisky.
O kit funciona no Codex, no Claude Code e no Google Antigravity. Ele transforma um documento de avatar e um documento de oferta em roteiros verticais de conversão direta. O aluno sempre escolhe os modelos pelos códigos do catálogo. O sistema não escolhe modelos automaticamente.
O Que Você Recebe
- 100 modelos aprovados, baixados somente após a ativação da máquina.
- Comando
/creative-modelspara consultar códigos. - Comando
/gerar-roteiropara gerar roteiros. - Comando
/creative-ingestpara analisar um criativo validado. - Comando
/creative-ingest-batchpara processar TXT, CSV, YAML ou Google Sheets. - Templates de avatar e oferta.
- Licença individual vinculada a uma máquina.
Instalação
Você precisa de Node.js 18 ou superior, Python 3.10 ou superior e de pelo menos um cliente compatível: Codex, Claude Code ou Google Antigravity. Não é necessário ter conta no GitHub ou no npm.
npx --yes script-ads-validados-wisky@latestO instalador solicitará o E-mail usado na compra, criará a pasta
~/script-ads-validados-wisky e preparará os componentes necessários. Se o
endereço estiver na lista autorizada e ainda não estiver vinculado a outro
computador, a biblioteca será baixada e registrada nesta máquina.
Depois, abra a pasta script-ads-validados-wisky da sua pasta pessoal como projeto
no Codex. Os comandos ficam disponíveis dentro desse projeto. Reinstalações e
atualizações na mesma máquina são permitidas; uma máquina diferente exige
liberação manual de Lucas.
No Claude Code, inicie uma nova sessão dentro da pasta instalada:
cd ~/script-ads-validados-wisky
claudeOs comandos do Claude Code vivem em .claude/skills/. Se a sessão já estava
aberta durante a instalação, encerre-a e execute claude novamente nessa pasta.
Na primeira abertura, confirme que confia na pasta. Depois digite / para ver os
seis comandos do produto.
Cada ação deve aparecer uma única vez no menu. As versões 1.2.1 e 1.2.2
continham atalhos legados duplicados; a atualização atual remove somente esses
arquivos gerenciados e oculta os skills internos source-command-*. Depois de
atualizar, encerre e abra o Claude Code novamente.
No Google Antigravity IDE, abra a pasta instalada como workspace:
~/script-ads-validados-wiskyDepois inicie uma nova conversa e digite /. Os seis comandos ficam registrados
como workflows em .agents/workflows/; os manuais operacionais ficam em
.agents/skills/. Se o workspace já estava aberto durante a atualização, feche e
abra a pasta novamente antes de iniciar a conversa.
O pacote público do npm contém somente o instalador e os comandos. Os modelos dos criativos não são publicados no npm e só são entregues após a validação da licença.
O FFmpeg necessário para vídeo é instalado dentro do ambiente isolado. Não é necessário instalar o FFmpeg globalmente.
Primeiro Uso
Consulte o catálogo:
/creative-modelsAtive a geração:
/gerar-roteiroEm seguida, envie:
Documento da oferta: anexado
Documento do avatar: anexado
Modelos: 10, 8, 35, 57
Quantidade por modelo: 1Você também pode dar tudo no comando e anexar os dois documentos:
/gerar-roteiro --models 10,8,35,57 --count 1Ingerir Seus Próprios Criativos
Antes da primeira ingestão, execute:
/creative-ingest-setupO terminal solicitará as chaves GEMINI_API_KEY e OPENAI_API_KEY sem exibi-las.
Não envie essas chaves no chat. Elas ficam somente no .env deste computador.
As chamadas e os custos das APIs são cobrados diretamente nas contas do aluno.
Teste um vídeo sem chamar APIs:
/creative-ingest "LINK_DO_DRIVE_OU_CAMINHO_DO_VIDEO" --dry-runExecute a ingestão real removendo --dry-run. O pipeline preserva o original,
analisa o vídeo inteiro com Gemini, extrai o áudio com FFmpeg, transcreve com
OpenAI, sintetiza o framework e aplica o quality gate.
Modelos criados pelo aluno recebem códigos como local-000001. Eles aparecem em
/creative-models e podem ser usados junto com modelos Wisky:
/gerar-roteiro --models local-000001,10 --count 1Ingestão Em Lote
Comece sempre pelo dry-run:
/creative-ingest-batch criativos.csv --dry-runDepois execute sem --dry-run. No CSV ou Sheets, use as colunas
Nome do criativo, Link, Vídeo ou Imagem, Qtde de campanhas,
Data da análise e Nome do Modelo do ingest.
Para Google Sheets com escrita de volta, configure o JSON OAuth Desktop local:
/creative-ingest-setup --google-client "/caminho/client_secret.json"
/google-sheets-authO token do Google fica em .secrets/. Sem OAuth, TXT, CSV e YAML continuam
disponíveis normalmente.
Resultado Obrigatório
Cada roteiro contém conceito e ângulo, copy falada, cenas com timestamps, primeiro frame, enquadramentos e gestos, textos na tela, cortes e edição, B-roll, objetos e cenário, prova visual, apresentação da oferta e CTA final.
Escolha Dos Modelos
O catálogo informa código, nome, estágio do funil e contexto de uso. A decisão é sempre do aluno. Códigos aceitos:
10
000010
m10
model-10
model-000010
10,8,35,57
local-1
local-000001
l1Os modelos são usados na mesma ordem informada. A licença da máquina é validada antes de consultar o catálogo ou carregar qualquer modelo.
Seus Documentos
Você pode anexar os documentos diretamente ao chat ou preencher os arquivos de
templates/ e colocá-los em inputs/. O conteúdo de inputs/ e outputs/ é
ignorado pelo Git e permanece local.
Atualização
Quando Lucas publicar uma nova versão:
npx --yes script-ads-validados-wisky@latestO instalador reconhece a instalação existente e preserva licença, inputs/,
outputs/, .env, .secrets/ e a biblioteca local em workspace/.
Validação Manual
node scripts/run-python.mjs license_client.py checkLimites De Uso
Este material é privado, educacional e licenciado individualmente. Não publique,
revenda, redistribua ou compartilhe a biblioteca e seus modelos. Consulte
LICENSE.md.
Vídeos, links, transcrições, evidências e modelos ingeridos pelo aluno ficam em
workspace/, que é ignorado pelo Git e nunca entra nas atualizações do npm.
