Communitygithub.com

MonsterDylan/instagram-agent-skill

Escreva 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 faça o lint antes de publicar. Use quando o usuário disser "escreva a legenda", "legendar isto", "o que coloco na descrição", tiver um Reel ou carrossel pronto e precisar do texto, ou perguntar sobre hashtags.

O que é instagram-agent-skill?

Esta skill cria legendas otimizadas para Instagram, tratando cada postagem como um problema de conversão e buscabilidade. Ela implementa as melhores práticas de 2025, reconhecendo que hashtags não aumentam alcance (após o limite de 5 imposto pela plataforma) e que os termos de busca no texto da legenda são o principal mecanismo de descoberta. A skill distingue dois tipos de legenda: Job A (quando o Reel já tem um gancho forte nos primeiros segundos) e Job B (quando a própria legenda precisa fisgar o usuário, como em fotos e carrosséis). Ferramentas integradas incluem um linter que verifica contagem de caracteres, número de pedidos, densidade de emojis e presença de links proibidos, além de validar termos de busca com `caption.py`. O fluxo de trabalho orienta o usuário a decidir o tipo de legenda, rascunhar, rodar o lint com `--keywords`, corrigir falhas e imprimir um recibo claro com métricas como caracteres visíveis, número de hashtags e localização dos termos de busca. A skill suporta qualquer plataforma baseada em terminal (Claude Code, Cursor, Codex, etc.) e é especialmente útil para profissionais de marketing, criadores de conteúdo e agências que gerenciam múltiplas contas no Instagram.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MonsterDylan/instagram-agent-skill/tree/HEAD/skills/ig-caption

Perguntar na sua IA favorita

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

Documentação

ig-caption

Uma ferramenta está 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 como o feed a imprime: 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 é ignorada.

Trabalho A: o vídeo já fisgou. 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. Seu trabalho é 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 linha um é o gancho e funciona exatamente como um gancho de Reel: concreto, curto e cortado em um precipício, não no meio de uma oração.

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

O formato

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. 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 é de 2.200 caracteres e quase nada precisa de 2.200. Uma legenda que merece o toque e então 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 no produto. O Instagram limitou hashtags a cinco por postagem 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 rótulos de tópico. Se o usuário tem um bloco de vinte salvas em seu bloco de notas, esse bloco agora é peso morto e o linter vai falhar.

#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 normal. "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, então 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 "não uso esta plataforma". Bio ou DM.
  • Um pedido. Dois pedidos é o mesmo que nenhum. caption.py os conta.
  • O pedido com palavra-chave precisa de uma palavra que as pessoas possam digitar. Uma palavra, sem espaços, sem emoji, e diga-a 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 decoração. O linter sinaliza qualquer coisa acima de 4 por 100 caracteres.
  • O 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. Rascunhe.
  3. Execute /ig-human nele. Legendas são curtas, então a porcaria é mais alta 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, então 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.

Habilidades Relacionadas