Communitygithub.com

ig-caption

Escrever a legenda do Instagram — a linha que sobrevive ao corte do '... mais', o corpo, o único pedido, os termos de busca e as três hashtags — e lintá-la antes de publicar. Use quando o usuário disser 'escreve a legenda', 'legenda isso', 'o que coloco na descrição', tiver um Reel ou carrossel pronto e precisar do texto, ou perguntar sobre hashtags.

O que é ig-caption?

Esta skill gera legendas otimizadas para o Instagram, focando na linha de abertura que aparece antes do corte '... mais' e em todo o texto que a acompanha. Ela ajuda você a decidir se a legenda deve complementar um vídeo que já prendeu a atenção (Job A) ou funcionar como o próprio gancho (Job B). A ferramenta aplica regras editoriais modernas: limite de 5 hashtags (conforme mudança do Instagram em dezembro de 2025), ênfase em termos de busca no texto da legenda (não em hashtags), um único pedido de ação por legenda, e linting rigoroso que verifica comprimento, uso de emojis e links. Funciona com um script Python que aceita um arquivo de texto e palavras-chave opcionais, imprimindo o resultado formatado com um resumo das métricas. É indicada para criadores de conteúdo, social media managers e qualquer pessoa que publique Reels ou carrosséis e queira legendas que convertam sem depender de táticas ultrapassadas.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/pierrernrd04-ai/traceo-reels/tree/HEAD/studio/skills/ig-caption

Perguntar na sua IA favorita

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

Documentação

O que ig-caption faz?

Uma ferramenta vive nesta pasta e executa:

python3 caption.py caption.txt
python3 caption.py caption.txt --keywords "propostas para clientes,precificação de agência"

Ela imprime a legenda do jeito que o feed a mostra: os primeiros 125 caracteres em uma caixa, todo o resto atrás do toque. Leia essa caixa antes de ler qualquer outra coisa que você escreveu.

Primeiro, decida qual trabalho esta legenda tem

Esta é a decisão que estraga legendas quando é pulada.

Trabalho A: o vídeo já prendeu a atenção. Um Reel carrega seu próprio gancho nos primeiros dois segundos, falado e na tela. A legenda não é um segundo gancho e competir com o vídeo é como perder ambos. O trabalho dela é o pedido, o contexto que faz o pedido fazer sentido e as palavras que as pessoas buscam.

Trabalho B: a legenda é o conteúdo. Uma foto, uma imagem única, uma capa de carrossel que abre um ciclo. Aqui a linha um é o gancho e funciona exatamente como um gancho de Reel: concreto, curto e cortado em um precipício em vez de no meio de uma oração.

Pergunte qual você está escrevendo. Se o usuário tiver um Reel com um gancho forte, escreva A e diga por quê.

A forma

Linha 1     125 caracteres de espaço visível. Trabalho A: o pedido, de forma clara.
            Trabalho B: o gancho.
            Nunca uma saudação, nunca uma hashtag, nunca um emoji como primeiro
            caractere.
Corpo       parágrafos curtos, uma linha de espaço em branco entre cada um. De dois a seis
            deles. É aqui que os termos de busca vivem.
O pedido    um. Comente uma palavra-chave, salve ou DM. Um.
Hashtags    até cinco, na própria linha no final, ou nenhuma.

O limite é de 2.200 caracteres e quase nada precisa de 2.200. Uma legenda que merece o toque e depois entrega 600 caracteres vence uma que entrega 1.800.

Hashtags, honestamente

Hashtags não são mais uma alavanca de alcance, e a plataforma já disse isso com uma mudança de produto. O Instagram limitou hashtags a cinco por postagem em 18 de dezembro de 2025, de trinta, dizendo aos criadores que 'usar menos (até 5) hashtags mais direcionadas, em vez de muitas genéricas' tem melhor desempenho. Adam Mosseri já havia dito em fevereiro de 2025 que hashtags não funcionam para aumentar o alcance e são um rótulo, não uma alavanca de distribuição.

Então: até cinco, específicas, como rótulos de tópico. Se o usuário tiver um bloco de vinte salvas no aplicativo de notas, esse bloco agora é peso morto e o linter vai reprová-lo.

#viral, #fyp, #explorepage, #foryou não descrevem nada. Corte-as.

Termos de busca importam mais do que hashtags agora

A busca do Instagram lê o texto da legenda. Portanto, a frase pela qual o usuário quer ser encontrado vai na legenda como uma frase que um humano digitaria, em uma frase que soa natural. 'Propostas para clientes' como palavras na linha três, não '#propostasparaclientes' em um bloco no final.

Peça dois ou três desses termos, depois passe-os para o linter:

python3 caption.py rascunho.txt --keywords "propostas para clientes,precificação de agência"

Regras

  • Sem link na legenda. Legendas não são clicáveis. Uma URL no corpo é texto morto que diz 'Eu não uso esta plataforma'. Bio ou DM.
  • Um pedido. Dois pedidos é o mesmo que nenhum. caption.py conta eles.
  • O pedido de palavra-chave precisa de uma palavra-chave que as pessoas possam digitar. Uma palavra, sem espaços, sem emoji, e diga em voz alta no vídeo também. Comente CONTRATO funciona. Comente 'o guia do contrato' não funciona.
  • Escreva o primeiro comentário separadamente se houver um link. Diga isso no recibo.
  • Emoji como pontuação, não como decoração. O linter sinaliza qualquer coisa acima de 4 por 100 caracteres.
  • Texto alternativo vale 20 segundos. Para carrosséis e fotos, escreva-o. Ele é lido por leitores de tela e pelo Instagram.

O ciclo

  1. Decida Trabalho A ou Trabalho B e diga qual.
  2. Esboce.
  3. Execute /ig-human nele. Legendas são curtas, então o 'slop' é mais alto aqui do que em qualquer outro lugar do pacote.
  4. Execute caption.py com os termos de busca do usuário. Corrija cada FALHA. Decida sobre cada AVISO em voz alta em vez de silenciosamente.
  5. Imprima o bloco pronto para copiar, depois o recibo:
LEGENDA PRONTA
trabalho:   A - o reel carrega o gancho
visível:    118 de 125 caracteres usados antes do corte
pedido:     um, comente CONTRATO
hashtags:   3
busca:      'propostas para clientes' na linha 3, 'precificação de agência' na linha 5
linter:     PRONTO

Nada é postado. O usuário cola.

Individual skills in this repo

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

Habilidades Relacionadas