Communitygithub.com

ig-caption

Gera legendas para Instagram: a linha que sobrevive ao corte "... mais", o corpo, o único pedido, os termos de busca e até cinco hashtags — com verificação de qualidade antes de publicar.

O que é ig-caption?

Esta skill cria legendas para Instagram que funcionam de verdade. Ela entende que o formato mudou: as hashtags não são mais alavancas de alcance (desde que o Instagram limitou a cinco por post em dezembro de 2025 e Adam Mosseri confirmou que elas são apenas rótulos), e que os termos de busca dentro do texto da legenda são agora mais importantes. A skill primeiro decide se a legenda é do Tipo A (o vídeo já prendeu, então a legenda só faz o pedido e dá contexto) ou Tipo B (a legenda é o conteúdo, com um gancho forte na primeira linha). Ela respeita o espaço visível de 125 caracteres, evita saudações e hashtags no início, recomenda no máximo cinco hashtags específicas, e usa um linter (caption.py) para verificar regras como: um único pedido, sem links na legenda, emojis como pontuação (máximo 4 a cada 100 caracteres), e os termos de busca inseridos naturalmente no texto. A skill também lê o arquivo de voz do usuário (~/.claude/instagram/voice.md) para manter a consistência estilística, ou infere a voz a partir de posts anteriores. O resultado final é um bloco de legenda pronto para copiar, acompanhado de um recibo que mostra quantos caracteres estão visíveis, quantos hashtags foram usados, onde estão os termos de busca e se o linter aprovou tudo. Suporta plataformas como Claude Code e usa ferramentas de linha de comando Python.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ilijachrchev/skills/tree/HEAD/skills/instagram-agent-skill/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?

Nesta pasta há uma ferramenta que executa:

python3 caption.py caption.txt
python3 caption.py caption.txt --keywords "client proposals,agency pricing"

Ela imprime a legenda exatamente como 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.

Voz

Leia ~/.claude/instagram/voice.md se existir e escreva nele: as palavras que o usuário realmente usa, aquelas que ele nunca diria, como ele lida com emojis e palavrões, e a prova de que ele fica feliz em colocar o nome dele. Se não existir, peça duas ou três coisas que ele já publicou, deduza a voz a partir delas, e ofereça-se para escrever o arquivo para que a próxima skill o tenha.

Primeiro, decida qual trabalho esta legenda tem

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

Trabalho A: o vídeo já prendeu eles. 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 os dois. O trabalho dela é o pedido, o contexto que faz o pedido fazer sentido, e as palavras que as pessoas pesquisam.

Trabalho B: a legenda é o conteúdo. Uma foto, uma imagem única, uma capa de carrossel que abre um ciclo. Aqui a primeira linha é 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 deles você está escrevendo. Se o usuário tem um Reel com um gancho forte, escreva A e diga por quê.

A estrutura

Linha 1     125 caracteres de espaço visível. Trabalho A: o pedido, claramente.
            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 envie DM. Um.
Hashtags    até cinco, em sua própria linha no final, ou nenhuma.

O limite é 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 as hashtags a cinco por post em 18 de dezembro de 2025, reduzindo 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.

Portanto: até cinco, específicas, como etiquetas de tópico. Se o usuário tem 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-os.

Termos de busca importam mais do que hashtags agora

A busca do Instagram lê o texto da legenda. Então 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. "Client proposals" como palavras na linha três, não "#clientproposals" em um bloco no final.

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

python3 caption.py draft.txt --keywords "client proposals,agency pricing"

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 único pedido. Dois pedidos é o mesmo que nenhum. caption.py conta eles.
  • O pedido de palavra-chave precisa de uma palavra 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.
  • Escreva o primeiro comentário separadamente se houver um link. Diga isso no recibo.
  • Emoji como pontuação, não decoração. O linter sinaliza qualquer coisa acima de 4 a cada 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. Faça um rascunho.
  3. Execute /ig-human nele. Legendas são curtas, então o entulho é mais perceptível 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, não 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, comentar CONTRATO
hashtags:       3
busca:          "client proposals" na linha 3, "agency pricing" na linha 5
linter:         PRONTO

Nada é publicado. O usuário cola.

Individual skills in this repo

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

Habilidades Relacionadas