Thread Carousel

thread-carousel

Carrossel de Instagram que imita uma thread do Twitter: fundo branco, cabeçalho com avatar e @, texto preto em parágrafos curtos, e no máximo um bloco visual por slide.

• Saída: slide-01.png … slide-NN.png em 1080×1350, mais um preview.html
• Render: Chrome ou Edge headless, que já existem na máquina. Sem Playwright, sem Puppeteer, sem pip install
• Custo: grátis, exceto se você gerar imagem no kie.ai (custa crédito, e nunca roda sem aprovação)

Convenção de caminho

Nunca invente caminho. Se o usuário não disser onde, use carrosseis/<tema-em-slug>/ a partir da pasta atual.

Passos

1. Receber o tema

O usuário passa um tema. Se ele já mandou print, foto ou screenshot, guarde os caminhos — essas imagens entram no carrossel como estão, sem gerar nada.

Antes de escrever, decida quantos slides: 8 a 10 é o padrão do formato. Menos de 6 não sustenta a promessa do gancho; mais de 10 ninguém termina.

2. Pesquisar — só quando o tema for factual

Carrossel factual com número inventado é o único jeito de esta skill causar dano de verdade. Todo número que aparecer no carrossel tem que ter vindo de uma fonte que você abriu.

3. Perfil

O cabeçalho precisa de nome, arroba e avatar, e eles aparecem nos dez slides: errar o @ custa uma renderização inteira. Confirme com o usuário na primeira vez, não deduza de outra rede.

Isso mora num config.json na raiz dos carrosséis. O script procura ao lado do spec e vai subindo até 3 pastas, então um único arquivo serve para todos os carrosséis:

{
  "nome": "Anderson Adelino",
  "arroba": "@oandersonadelino",
  "avatar": "perfil.jpg"
}

avatar é relativo à pasta do config, não à do spec. Tem um modelo pronto em assets/config.example.json.

Se um carrossel específico precisar de outro perfil (cliente, segunda conta), basta pôr perfil no próprio spec: ele ganha do config.

Sem config.json e sem perfil no spec, o script para e diz o que falta. Sem avatar ele roda, mas cai num círculo com a inicial: avise que fica bem melhor com a foto.

4. Escrever a copy

A estrutura abaixo é o que faz o formato funcionar. Cada slide tem um trabalho:

O CTA não promete entrega futura. me segue que eu vou testar e contar, semana que vem eu trago a parte 2, vou fazer um tutorial disso são dívidas que você assina em nome do usuário e que ele vai ter que pagar. Quem seguiu por causa da promessa cobra, e quem não vê a promessa cumprida desmarca.

Convite para seguir, sim. Compromisso datado, não. A única coisa que o CTA pode afirmar é o que a conta já faz.

8 a 10 slides, e 8 é um número legítimo. Se um slide só repete o vizinho ou existe pra fechar a conta, corte: o carrossel fica mais forte com 8 slides que o leitor termina do que com 10 em que ele para no sexto. Enche linguiça é o único jeito garantido de perder a pessoa no meio.

A desescalada não é opcional. É ela que separa este formato de clickbait: o gancho promete o extremo, e o meio do carrossel devolve a medida certa. Sem isso, o slide 1 vira mentira.

Assinatura visual: parágrafos de 1 a 3 linhas, sempre com linha em branco entre eles (\n\n no JSON). Parágrafo grande quebra o formato.

Emoji: 🚨 urgência · ⚠️ risco · ✅ lista · ➡️ 👉 continua · 😳 reação. No máximo 2 por slide.

A seta 👉 / ➡️ é promessa, não pontuação. Use só quando o slide arma algo que vem no próximo — "E qual foi a acusação?👉". Slide que fecha uma ideia termina normal, ou em ⚠️ / 😳. No carrossel de referência, 3 dos 10 slides não têm seta nenhuma. Seta em todo slide vira tique e o leitor para de acreditar nela.

CAPS: no máximo uma palavra por slide (TRILHÃO, JUSTAMENTE, FUNCIONAM). Duas já vira grito.

Travessão é proibido. Nunca use — nem – na copy. É a pontuação que mais denuncia texto de IA, e ninguém escreve assim no Instagram. Onde daria vontade de usar travessão, quebre a frase:

Vírgula, dois-pontos ou ponto final. Nessa ordem de preferência.

Não escrever como IA

O travessão é só o sintoma mais visível. O que entrega texto de IA é o ritmo: toda frase do mesmo tamanho, deslizando sem travar em nada. Texto humano respira. Leia o slide em voz alta antes de aceitar. Se travar na boca, reescreva.

Conectivo de manual é lixo. Parágrafo novo já faz a transição sozinho:

além disso · portanto · contudo · consequentemente · ademais · não obstante · é importante ressaltar · vale destacar · cabe ressaltar · no cenário atual · nos dias de hoje · em última análise · um verdadeiro testemunho

Vocabulário de brochure, banido. Se você não falaria numa reunião, não escreve:

robusto · sinergia · otimizar · potencializar · aprimorar · alavancar · implementar · inovador · transformador · disruptivo · holístico · multifacetado · abrangente · paisagem · reino · jornada · tapeçaria · aprofundar · navegar (no figurado)

Em inglês as mesmas: delve · tapestry · realm · landscape · moreover · furthermore · it's important to note · unlock · leverage · seamless.

Três fórmulas proibidas, porque são o esqueleto de texto de IA:

Isso não proíbe a desescalada do slide 7. Mas calma, não é que X é uma correção de rota, e é dita em voz alta o tempo todo. O que está banido é a antítese decorativa, do tipo não é sobre ferramentas, é sobre pessoas.

Abertura e fechamento. Sem redação escolar (Em um mundo cada vez mais…) e sem encerramento de TED (no fim das contas, a jornada só começou). O slide 1 abre com o fato. O slide 10 chama pra seguir e acabou.

Orçamento de caracteres

Medido no Chrome, não estimado. Acima do orçamento o texto de todos os slides encolhe junto, porque o carrossel usa um único tamanho de fonte:

Escreva dentro da primeira coluna. O script avisa qual slide estourou e quanto, antes de renderizar.

Foto única cabe menos que foto dupla, porque o bloco passa de 464px para 540px e o texto perde uma linha. E este é o único estouro que sai sem barra vermelha: o ajuste de fonte da página mede o texto, não a imagem, então o que acontece é a foto ser cortada na borda de baixo do slide. Se a imagem do seu slide parece "faltar um pedaço embaixo", é isso, e a correção é encurtar o texto.

Em slide de foto única, conte linha, não caractere: no máximo 6. O orçamento de 230 é conservador de propósito, porque o que estoura é linha, e parágrafo que termina no meio da linha gasta a linha inteira. Lista é o caso pior, já que cada → custa uma linha cheia por mais curta que seja.

Tem piso também: 30% do orçamento. O conteúdo é centralizado no slide, mas centralizar pouco texto num quadro de 1350px continua parecendo vazio. No primeiro carrossel de verdade, um slide de citação usou 7% e outro 19%, e os dois ficaram com cara de rascunho.

Se um slide não chega lá, ele não tem assunto próprio: junte com o vizinho ou corte. Slide fraco custa mais que slide a menos, porque é onde a pessoa para de arrastar.

O CTA é a exceção. O último slide é curto de propósito, e o da referência tem 150 caracteres. Não encha ele para bater a cota.

5. Resolver as imagens

Nem todo slide precisa de bloco visual — na referência, metade é só texto. Use bloco quando ele acrescenta prova, não decoração.

python "<SKILL-FOLDER>/scripts/build-carousel.py" baixar "<url-da-imagem>" --out "<OUT>/img/01"
python "<SKILL-FOLDER>/scripts/build-carousel.py" stock "courtroom exterior" --out "<OUT>/img/02"
python "<SKILL-FOLDER>/scripts/build-carousel.py" imagem "prompt em ingles" --out "<OUT>/img/03" --aspect 1:1

Os três baixam pro disco e conferem os bytes. A extensão final sai do conteúdo, então o comando imprime o caminho que realmente gravou — use esse.

Antes de chamar imagem: mostre o prompt ao usuário e espere o "pode". Gerar imagem custa crédito e não dá pra desfazer a cobrança.

6. Montar o spec e renderizar

Um JSON, um comando. Caminhos de imagem são relativos à pasta do spec.

{
  "titulo": "Meta no tribunal",
  "perfil": {"nome": "...", "arroba": "@...", "avatar": "perfil.jpg"},
  "slides": [
    {"texto": "🚨AGORA: ...\n\nVou te atualizar 👉", "imagens": ["img/01.jpg", "img/02.jpg"]},
    {"texto": "..."},
    {"texto": "...", "card": {"fonte": "g1", "cor": "#c4170c", "chapeu": "TECNOLOGIA",
                              "titulo": "manchete real", "texto": "linha de apoio"}},
    {"texto": "...", "citacao": {"texto": "...", "destaque": "trecho em amarelo"}}
  ]
}

• imagens aceita 1 (larga) ou 2 (lado a lado). Mais que isso é ignorado
• card.cor é a cor da tarja do veículo: g1 #c4170c, Folha #12326e, UOL #001e64, CNN #cc0000, Estadão #0a3d62
• citacao.destaque precisa aparecer literalmente dentro de citacao.texto, senão o script para
• Um bloco por slide. Dois blocos no mesmo slide é erro, não escolha

python "<SKILL-FOLDER>/scripts/build-carousel.py" montar "<OUT>/spec.json" --out "<OUT>"

7. Conferir antes de entregar

O script já confere sozinho que cada PNG existe e saiu exatamente 1080×1350 — ele para se não saiu. O que você ainda precisa fazer:

1. Abrir o preview.html e olhar. Se algum slide tiver uma barra vermelha TEXTO NÃO COUBE, aquele slide não pode ser postado: encurte o texto e rode de novo. A barra é proposital, ela existe pra ser impossível de ignorar
2. Se o script avisou "o slide N encolhe a fonte de TODOS", encurte esse slide. Um slide longo demais derruba o tamanho do carrossel inteiro
3. Conferir que toda foto de pessoa real veio de fonte real, não do kie.ai

8. Reportar

✅ Carrossel pronto

📁 Pasta:   <OUT>
🖼️  Slides:  N arquivos, 1080×1350
👀 Preview: <OUT>/preview.html

Fonte: <veículo + link, quando for tema factual>
Imagens: X do usuário · Y buscadas · Z geradas no kie.ai

Ofereça: reescrever um slide, trocar uma imagem, mudar a ordem.

Chaves

Nenhuma das duas é obrigatória: sem elas o carrossel sai com as imagens do usuário, com as que você baixou da web, ou só com texto. O script lê as chaves do ambiente ou de um .env, e lê só a chave que precisa — nunca o .env inteiro, que no projeto de outra pessoa está cheio de credencial alheia.

Guardrails

• Nunca gere foto realista de pessoa real identificável no kie.ai, nem screenshot falso de notícia, rede social ou documento. Pessoa ou evento real → foto buscada ou print do usuário. Um carrossel factual com imagem fabricada é desinformação, mesmo quando o texto está certo
• O bloco card é uma manchete real de um veículo real. Não invente manchete, não invente veículo, não mude o sentido do título pra caber
• Logo é marca registrada: baixe o de verdade, nunca gere no kie.ai. Um modelo sempre devolve o logo quase certo, e quase certo num logo é falsificação. O Wikimedia Commons serve, e ele exige User-Agent próprio: curl -A "..." "https://commons.wikimedia.org/wiki/Special:FilePath/<Arquivo>.svg?width=1024" já entrega PNG. Usar o logo de uma empresa num carrossel sobre aquela empresa é uso editorial e está certo; o que não pode é passar por ela
• imagem nunca roda sem aprovação. Custa crédito
• Nunca reporte "pronto" sem ter aberto o preview. O script garante dimensão, não garante que a copy ficou boa nem que nenhum slide estourou
• Não sobrescreva pasta de carrossel existente — o script recusa
• Todo número factual sai de uma fonte que você abriu

Problemas