dobralabs/ccos-ratos/carrossel

/carrossel — Criação de Carrossel

Setup (primeira vez)

Antes de criar qualquer carrossel, checar 5 coisas. Se tudo estiver OK, pular direto pro workflow. Se faltar algo, resolver na hora de forma conversacional.

1. Design guide

Ler o guia de design da marca (a linha "marca" do mapa no AGENTS.md da raiz diz onde ele mora). Se os campos estiverem vazios (template padrão):

"Pra criar o carrossel com a tua cara, preciso de algumas coisas. Me conta:

1. Qual a cor principal da tua marca? (hex tipo #FF5C35, ou descreve: "azul escuro", "laranja quente")

2. Tem preferência de fonte? (Se não, eu escolho uma boa pro teu estilo)

3. Tem logo? Se sim, joga o arquivo na pasta da marca (te digo o caminho) e me diz o nome"

Com as respostas, preencher a parte de identidade do guia de design (logo, cores, fontes). O estilo visual do carrossel não vai pro guia: é escolha só do carrossel (passo 2 abaixo). A partir da cor principal, gerar variações claras e escuras pra usar nos slides (uma versão mais clara pro destaque sutil, uma mais escura pra fundos). Escolher um fundo escuro e um fundo claro que combinem com o tom da cor (cores quentes pedem fundos mais aconchegantes, cores frias pedem fundos mais neutros).

Se o usuário disser "não sei" ou "escolhe pra mim": propor uma cor principal e um par de fontes que combinem com o negócio dele (o que ele faz está no contexto do negócio), mostrar e só gravar no guia com o ok.

2. Estilo de design dos slides

Ler references/design-carrossel.md. Se o arquivo contiver a linha <!-- estilo: pendente -->, significa que o usuário ainda não escolheu o estilo. Perguntar:

"Como tu quer o visual dos slides?

1. Minimalista: limpo, muito espaço em branco, layouts simples. Elegante e clean

2. Elaborado: texturas, composições ousadas, layouts variados. Impactante e marcante no feed

3. Tweet: simula um tweet/post do Twitter. Fundo branco, foto de perfil e @handle no topo, texto grande embaixo. Ultra-limpo e familiar"

Conforme a resposta, substituir o conteúdo inteiro de references/design-carrossel.md pelo conteúdo do arquivo de estilo escolhido:

• Minimalista: copiar conteúdo de references/design-minimalista.md
• Elaborado: copiar conteúdo de references/design-elaborado.md
• Tweet: copiar conteúdo de references/design-tweet.md

Se design-carrossel.md NÃO contiver <!-- estilo: pendente -->, o estilo já foi escolhido. Não perguntar de novo.

Se escolher tweet, perguntar também:

"Pra o estilo tweet, preciso de algumas coisas:

1. Teu nome (como quer que apareça no slide)

2. Teu @ do Instagram

3. Uma foto de perfil (joga na pasta da marca como foto-perfil.jpg; te digo o caminho). Se não tiver agora, uso as iniciais do teu nome

4. Quer o badge azul de verificado ao lado do nome? (sim/não)"

Salvar essas informações na seção ## Perfil do autor do guia de design pra não perguntar de novo:

## Perfil do autor
-**Nome:** [nome]
-**Handle:** @[handle]
-**Foto:** foto-perfil.jpg, na pasta da marca (ou "iniciais" se não tiver)
-**Badge verificado:** sim/não

Se o design guide já tiver a seção "Perfil do autor" preenchida, não perguntar de novo.

Se o usuário não souber ou não tiver preferência, usar elaborado como padrão.

O usuário pode trocar depois a qualquer momento: "muda o estilo do carrossel pra tweet" e o Claude copia o outro arquivo.

3. Tom de voz

Ler o tom de voz da marca (na pasta da marca; o carrossel fala com o público, não com o dono). Se não existir ou estiver vazio:

"Como tu prefere que eu escreva os textos dos slides?

- Informal e direto (papo de colega)?

- Profissional mas acessível?

- Técnico e denso?

E tem algo que te incomoda em texto de IA? (ex: travessões, emojis, frases curtas demais)"

Salvar no tom de voz da marca (o arquivo tom-de-voz.md na pasta da marca; criar se não existir).

4. Contexto do negócio

Ler _contexto/empresa.md. Se estiver vazio, avisar:

"Ajuda se eu souber sobre o teu negócio e público pra escrever melhor. Roda /setup pra configurar, ou me conta rápido: o que tu faz e pra quem."

Se o usuário responder rápido (sem rodar /setup), anotar o essencial em _contexto/empresa.md.

5. Playwright

Verificar se Playwright tá instalado:

npx playwright screenshot --help 2>/dev/null && echo "OK" || echo "INSTALAR"

Se precisar instalar:

npx playwright install chromium

Avisar o usuário que tá instalando (demora uns 30s na primeira vez).

Dependências

• Identidade visual: o guia de design da marca (a linha "marca" do mapa no AGENTS.md da raiz diz onde ele mora; se o projeto tem marca/ própria, vale a dele) (preenchido no setup ou antes)
• Regras de design: references/design-carrossel.md (dentro desta skill)
• Contexto: _contexto/empresa.md
• Tom de voz: o jeito de a marca falar com o cliente e com o público (o tom de voz, na pasta da marca; a linha "marca" do mapa do AGENTS.md diz onde ela mora). Sem ele, as preferências do dono (_contexto/preferencias.md) servem de base, mas elas dizem como falar com o dono, não com o cliente
• Playwright CLI: npx playwright screenshot

Input

O usuário fornece:

• Tema, ideia, texto livre, link ou arquivo de referência
• Imagens (opcional): se anexar fotos, usar nos slides. Se não, criar design visual sem foto
• Número do episódio ou série (se aplicável)

Workflow em 3 Fases

Fase 1 — Texto

1. Ler o tom de voz da marca pra calibrar o texto
2. Ler _contexto/empresa.md pra entender contexto e público
3. Se o input for um link, buscar o conteúdo com os fallbacks corretos:

• Links normais (artigos, blogs, docs): tentar WebFetch direto. Se falhar ou retornar pouco conteúdo, usar Jina Reader: prefixar a URL com https://r.jina.ai/ (ex: https://r.jina.ai/https://exemplo.com/artigo)
• Links do X/Twitter (x.com ou twitter.com): substituir o domínio por api.fxtwitter.com e usar WebFetch (ex: https://x.com/user/status/123 vira https://api.fxtwitter.com/user/status/123). Funciona também pra x.com/i/status/ID. Retorna texto, mídia e links do tweet sem precisar de login
• Links do Instagram: WebFetch não funciona. Avisar o usuário pra copiar o texto do post e colar direto
• Links de YouTube: se tiver a skill /yt-transcript ou /transcribe, usar. Se não, tentar WebFetch na página

1. Se o usuário mencionar algo que tu não conhece ou não tem certeza do que é (nome de produto, ferramenta, evento, pessoa, termo técnico): pesquisar antes de escrever. Usar WebSearch, WebFetch ou qualquer ferramenta disponível. Nunca chutar, corrigir o usuário ou assumir que ele errou. Se ele citou uma ferramenta ou termo que tu não conhece, vai atrás pra descobrir o que é. O usuário sabe do que tá falando, tu é que pode não saber
2. Definir o ângulo do carrossel: educacional, oportunidade, contrário, provocativo ou inspiracional

1. Briefing rápido — perguntar ao usuário (numa mensagem só):

> "Antes de escrever, me confirma: > - Quantos slides? (padrão: 8-10) > - Vai querer imagem na capa ou dentro dos slides? Se sim, quantas imagens tu tem? > - Se tiver imagens: joga na pasta conteudo/carrosseis/[tema]/imagens/ e me diz os nomes > - Se não tiver: faço um design visual que funciona bem sem foto > - Se quiser, posso gerar imagens por IA (ver seção Geração de Imagens abaixo) > - CTA do último slide? (ex: 'segue pra mais', 'link na bio', 'comenta X') > - Tipo: dica prática, tendência, opinião forte, bastidores, ou outro?"

Se o usuário responder tudo junto ("faz sobre X com 8 slides"), não ficar perguntando mais. Usar bom senso pros campos que faltaram.

Se o usuário fornecer imagens, criar a pasta conteudo/carrosseis/[tema]/imagens/ e confirmar que as imagens estão lá antes de seguir.

1. Planejar a espinha dorsal do carrossel e mostrar pro usuário. Montar e apresentar:

> Espinha dorsal do carrossel: > > Ângulo: [a opinião/tese do usuário sobre o assunto. Se ele disse "quero falar que X tá matando Y", esse é o ângulo. Nunca diluir] > > Tensão central: [a fricção, contradição ou dado surpreendente] > > Mecanismo: [por que isso acontece, a causa real] > > Provas: [2-3 evidências concretas] > > Virada: [o que muda pra quem tá lendo] > > 5 opções de capa: > A: [título] / [subtítulo] > B: [título] / [subtítulo] > C: [título] / [subtítulo] > D: [título] / [subtítulo] > E: [título] / [subtítulo] > > Qual capa tu prefere? E a narrativa tá no caminho certo ou quer ajustar algo?

CHECKPOINT 1: Esperar o usuário escolher a capa e aprovar a direção narrativa. Se ele quiser mudar o ângulo, ajustar a espinha dorsal antes de escrever. Só avançar quando a narrativa estiver alinhada.

Cada opção de capa deve ter título (max 8 palavras) + subtítulo próprio. Nunca o mesmo subtítulo pra todas. Precisa criar tensão ou curiosidade. Nunca descritivo ("5 dicas de X"), sempre com ângulo ("por que X não funciona como tu pensa").

1. Escrever os slides com base na espinha dorsal e capa aprovadas. Seguir o arco narrativo:

Slide 1 (Capa): usar a capa escolhida no checkpoint 1.

Slide 2 (Hook): Abre com um fato, dado ou situação que cria tensão. Contextualiza o problema e faz a pessoa querer entender o porquê. O slide termina preparando o terreno pro próximo (a pessoa precisa passar pro próximo pra resolver a tensão, sem precisar de "swipe pra ver mais").

Slides 3-4 (Mecanismo): Explica POR QUE isso acontece. Não é só "o que", é o motor por trás. Dados concretos aqui: número + fonte + ano. Se não tiver dado, usar um exemplo real e específico (nome de empresa, produto, caso). Nunca genérico.

Slides 5-7 (Provas e aprofundamento): Um ponto por slide, cada um aprofundando um aspecto diferente. Cada slide deve adicionar uma camada nova, não repetir o anterior com palavras diferentes. Se o slide 5 apresenta um dado, o slide 6 contradiz ou expande, o slide 7 conecta com a realidade do leitor.

Slide 8-9 (Virada): Aqui o carrossel muda de tom. Não é resumo do que foi dito. É uma virada genuína: "e o que isso significa pra quem tá lendo?" ou "o que muda a partir de agora?". Conexão prática e específica, não genérica.

Slide final (CTA): Chamada pra ação + menção ao canal/marca. Curto. O CTA precisa ter uma frase-ponte que conecta o conteúdo do carrossel com a ação (não um "segue pra mais" solto).

Regras de construção do texto:

• Cada slide é um parágrafo de reportagem, não uma lista disfarçada. 2-4 frases que fluem com conectivos naturais (porque, só que, por isso, enquanto, mas, então, aí)
• Artigos sempre presentes: "um mercado", "a marca", "os dados". Nunca cortar artigo pra economizar espaço
• Cada frase deve funcionar lida em voz alta. Se soar robótico, reescrever
• Preferir 2 frases curtas com ponto a 1 frase longa com vírgula. Ritmo é mais importante que economia
• Cada slide termina preparando o terreno pro próximo. A passagem entre slides deve ser inevitável pela tensão narrativa, não por aviso ("continue no próximo")
• Dentro de cada slide, o texto é um bloco coeso. Entre slides, há curiosity gap
• Toda afirmação factual precisa de especificidade: dado + fonte + ano. "O mercado cresceu 34% em 2024 (Statista)" em vez de "o mercado cresceu muito"
• Se não tiver dado verificável, não inventar. Melhor uma opinião forte e honesta do que um número falso