Skills@joaoguirunas

5 Skills pro Instagram no Claude

Instale 5 skills grátis no Claude Code e gere roteiro de reel, legenda, carrossel, nota do perfil e mensagens de Direct, com você aprovando tudo.

instagram-agent-skill
$ git clone https://github.com/Jakeschincariol/instagram-agent-skill
✓ repositório pronto para uso local

O que é

5 Skills pro Instagram no Claude

Neste tutorial você instala cinco das treze skills do repositório instagram-agent-skill no Claude Code: /ig-reel (roteiro com três ganchos e nota), /ig-caption (legenda e o trecho que aparece antes do "mais"), /ig-carousel (carrossel), /ig-profile (nota de 0 a 100 para o perfil) e /ig-dm (entrega para quem comenta a palavra e dois lembretes).

As skills são de terceiros (autor Jakeschincariol, licença MIT) e só escrevem texto: o README diz que nada é postado até você aprovar e que não há chave de API nem conexão com a conta. Você leva três formas de instalar, seis prompts prontos e a lista com link e comando de cada skill.

A ressalva: a execução das cinco skills não foi reproduzida nesta página, e o carrossel de 9 slides não é o padrão da skill (ela faz de 6 a 10), então o número precisa ser pedido no prompt.

Reel com 3 ganchos

O /ig-reel devolve três ganchos com nota, entre 26 fórmulas, antes de você gravar.

Legenda com prévia

O /ig-caption mostra os 125 caracteres que o feed exibe antes do "mais".

Carrossel slide a slide

O /ig-carousel escreve capa e slides em 1080x1350. Peça 9 slides no prompt.

Nota do perfil

O /ig-profile dá nota de 0 a 100 por uma rubrica de 12 partes e reescreve o que perdeu pontos.

Direct sem spam

O /ig-dm escreve a entrega e dois lembretes, e para no segundo.

Nível: iniciante · Tempo estimado: ~20 min para instalar e rodar a primeira skill, mais o tempo de preencher a sua voz de marca.

Atenção:

Repositório de terceiro, não é do João. Em 20/10/2026 ele tinha 2.182 estrelas, licença MIT e o último push em 13/09/2026. A instalação copia as 13 skills para ~/.claude/skills e vale para todos os seus projetos. Leia os arquivos SKILL.md antes de instalar, como faria com qualquer código que o Claude vai seguir.

Atenção:

Não testado neste tutorial: a execução real das cinco skills, o plugin (/plugin install) e a geração dos arquivos de imagem do carrossel. Os comandos e as funções vêm do README e dos SKILL.md lidos em 20/10/2026. Se algo se comportar diferente, vale o que o repositório disser.

Atenção:

As skills escrevem, você publica. O Instagram segue as próprias regras para Direct e para automação: o README cita respostas automáticas por palavra-chave apenas pelas ferramentas do próprio Instagram e parceiros aprovados, e só depois de a pessoa comentar. Nada aqui deve virar disparo para quem não pediu.

Pré-requisitos

  • Claude Code instalado e logado (instalação na documentação oficial: https://code.claude.com/docs)
  • git, para a instalação manual (git --version responde)
  • Python 3, porque as ferramentas locais (hookscore.py, caption.py, detect.py e outras) rodam com python3
  • Sem chave de API e sem login no Instagram: o README diz "no API key, nothing to connect"
  • Custo: as skills são grátis (MIT). O uso do Claude segue o seu plano

Conceitos-chave

  1. 01

    Skill

    Uma pasta com um arquivo SKILL.md que o Claude lê quando você chama o comando, por exemplo /ig-reel. O reel chama tudo de skill, e é isso mesmo aqui.

  2. 02

    Ferramentas locais

    Scripts Python que rodam na sua máquina, sem rede e sem enviar nada (hookscore.py nota os ganchos, caption.py confere a legenda). Fazem parte de algumas skills.

  3. 03

    Plugin

    Uma forma de instalar o pacote inteiro por /plugin, em vez de copiar pastas. O repositório oferece as duas.

  4. 04

    voice.md

    Um arquivo em ~/.claude/instagram com a sua voz. Todas as skills leem esse arquivo, e ele pesa mais no Instagram porque você precisa falar o texto em voz alta.

As 5 skills: link e instalação

As cinco do vídeo, com o link da pasta de cada uma no repositório. O comando de instalação do README copia as 13 de uma vez. A coluna Instalação traz a variação para copiar só aquela pasta, e cada skill é autocontida, com seus scripts dentro da própria pasta.

NomePara que serveLinkInstalaçãoTestado?
/ig-reelRoteiro de reel: 3 ganchos com nota, roteiro e texto na telahttps://github.com/Jakeschincariol/instagram-agent-skill/tree/main/skills/ig-reelcp -r instagram-agent-skill/skills/ig-reel ~/.claude/skills/Não testado neste tutorial
/ig-captionLegenda revisada e prévia dos 125 caracteres antes do "mais"https://github.com/Jakeschincariol/instagram-agent-skill/tree/main/skills/ig-captioncp -r instagram-agent-skill/skills/ig-caption ~/.claude/skills/Não testado neste tutorial
/ig-carouselCarrossel: capa, texto dos slides e arquivos 1080x1350https://github.com/Jakeschincariol/instagram-agent-skill/tree/main/skills/ig-carouselcp -r instagram-agent-skill/skills/ig-carousel ~/.claude/skills/Não testado neste tutorial
/ig-profileNota de 0 a 100 pela rubrica de 12 partes e reescritahttps://github.com/Jakeschincariol/instagram-agent-skill/tree/main/skills/ig-profilecp -r instagram-agent-skill/skills/ig-profile ~/.claude/skills/Não testado neste tutorial
/ig-dmEntrega por palavra-chave, primeira mensagem, pitch e dois lembreteshttps://github.com/Jakeschincariol/instagram-agent-skill/tree/main/skills/ig-dmcp -r instagram-agent-skill/skills/ig-dm ~/.claude/skills/Não testado neste tutorial

Passo a passo

  1. 01

    Confira git e Python

    Os dois precisam responder com uma versão.

    git --version python3 --version
  2. 02

    Instale pelo caminho manual (README)

    Clone o repositório e copie as pastas ig-* para as skills do Claude Code. Rode o cp na pasta onde o clone foi criado.

    git clone https://github.com/Jakeschincariol/instagram-agent-skill.git cp -r instagram-agent-skill/skills/ig-* ~/.claude/skills/
  3. 03

    Ou instale como plugin (README)

    Dentro do Claude Code, adicione o marketplace e instale. Este caminho não foi testado aqui.

    /plugin marketplace add Jakeschincariol/instagram-agent-skill /plugin install instagram-agent
  4. 04

    Ou peça ao próprio Claude (README)

    Cole o link do repositório numa conversa do Claude e peça a instalação. O README traz este texto como atalho.

    https://github.com/Jakeschincariol/instagram-agent-skill Install this skill, then confirm /ig-reel works.
  5. 05

    Abra uma sessão nova e confirme

    Abra uma sessão nova do Claude Code para as skills serem carregadas. Digite o comando e veja se o Claude reconhece a skill.

    /ig-reel
  6. 06

    Preencha a sua voz

    O README manda copiar templates/voice.md para ~/.claude/instagram/voice.md e preencher, ou pedir ao Claude para escrever a voz a partir de três posts seus (prompt abaixo).

    mkdir -p ~/.claude/instagram cp instagram-agent-skill/templates/voice.md ~/.claude/instagram/voice.md
  7. 07

    Rode as cinco, uma por vez

    Use os prompts da próxima seção na ordem: reel, legenda, carrossel, perfil e Direct. Leia o resultado de cada uma antes de passar para a próxima.

  8. 08

    Aprove e publique você mesmo

    O Claude entrega rascunho. Você revisa, ajusta e posta ou envia. As skills não publicam e não enviam mensagens.

A skill por skill: exemplo de uso

  1. 01

    /ig-reel

    Peça um tema e uma profissão. O README descreve três ganchos entre 26 fórmulas, com nota, e depois o roteiro, o texto na tela e uma linha do tempo.

    /ig-reel Reel de advogado trabalhista: demitido sem justa causa
  2. 02

    /ig-caption

    Entregue a legenda ou o resumo do reel. A skill confere a legenda e mostra o trecho que o feed exibe antes do "mais", cerca de 125 caracteres.

    /ig-caption
  3. 03

    /ig-carousel

    O SKILL.md faz de 6 a 10 slides por padrão, com limite de 20. Para ter 9, peça 9 no prompt.

    /ig-carousel Carrossel de 9 slides
  4. 04

    /ig-profile

    Dá a nota de 0 a 100 por uma rubrica de 12 partes e reescreve em ordem de correção, do que mais pesa ao que menos pesa.

    /ig-profile
  5. 05

    /ig-dm

    Escreve a entrega para quem comentou a palavra e os dois lembretes. O SKILL.md fixa em dois e manda parar depois do segundo.

    /ig-dm

Prompts prontos

Troque cada palavra entre colchetes pelo seu caso: [NICHO] é a sua área (ex.: advogado trabalhista), [TEMA] é o assunto do post, [PÚBLICO] é quem você quer atingir, [BIO] é o texto atual da sua bio, [PALAVRA] é a palavra que a pessoa comenta e [LINK] é o que você entrega. Os prompts que escrevem arquivo ou mensagem pedem o seu ok antes.

Prompt: roteiro de reel com 3 ganchos (o do vídeo)

/ig-reel Reel de [NICHO]: [TEMA] Mostre os 3 ganchos com a nota de cada um e espere eu escolher antes de escrever o roteiro.

Prompt: legenda com a prévia do "mais"

/ig-caption Escreva a legenda do reel sobre [TEMA] para [PÚBLICO]. Mostre o trecho que aparece antes do "mais" e diga se o gancho cabe nele.

Prompt: carrossel de 9 slides

/ig-carousel Carrossel de 9 slides, da capa ao resumo que a pessoa salva, sobre [TEMA] para [PÚBLICO]. Mostre o texto de cada slide e espere meu ok antes de montar qualquer arquivo.

Prompt: nota do perfil

/ig-profile Meu perfil é @[PERFIL] e a minha bio atual é: [BIO] Dê a nota de 0 a 100 pela rubrica e reescreva começando pelo que mais perdeu pontos.

Prompt: entrega por palavra-chave e dois lembretes

/ig-dm Quem comentar [PALAVRA] no meu post sobre [TEMA] vai receber [LINK]. Escreva a mensagem de entrega e os dois lembretes. Mostre tudo e não envie nada.

Prompt: criar o voice.md a partir de 3 posts

Escreva o meu voice.md a partir destes três posts meus: [POST 1] [POST 2] [POST 3]. Faça as perguntas que faltarem. Mostre o arquivo e só salve em ~/.claude/instagram/voice.md depois do meu ok.

Erros comuns

  • O comando /ig-reel não aparece → as pastas não foram para ~/.claude/skills ou a sessão já estava aberta → confira se existe ~/.claude/skills/ig-reel e reinicie o Claude Code
  • cp: No such file or directory → o cp foi rodado fora da pasta onde o git clone criou instagram-agent-skill → entre nessa pasta (ou use o caminho completo) e repita
  • O carrossel não veio com 9 slides → o padrão da skill é de 6 a 10 → peça "9 slides" no prompt
  • python3: command not found → as ferramentas locais precisam de Python 3 → instale o Python 3 e repita
  • O texto saiu genérico → o voice.md está vazio ou não existe → preencha a sua voz ou gere o arquivo a partir de três posts seus
  • /plugin install não encontra o instagram-agent → o marketplace não foi adicionado antes → rode o primeiro comando e depois o segundo, ou use a instalação manual
  • O /ig-dm avisou que mensagem fria rende pouco e pediu mais dados → a skill foca em quem já interagiu e exige um gatilho → informe o gatilho (o comentário ou a resposta ao story) antes de pedir o texto

Checklist final

  • git e python3 respondem no terminal
  • As pastas ig-* estão em ~/.claude/skills e o /ig-reel é reconhecido numa sessão nova
  • O voice.md foi criado e preenchido
  • Você pediu 9 slides no prompt do carrossel e conferiu a contagem
  • Cada texto foi revisado por você antes de postar ou enviar
  • Nenhuma mensagem de Direct foi enviada por fora do que o Instagram permite

Perguntas frequentes

O Claude posta no meu Instagram?

Não. O README diz que nada é postado até você aprovar: as skills escrevem e você publica. Elas também não usam chave de API nem se conectam à conta.

Quantas skills tem o repositório?

Treze, segundo o README em 20/10/2026, sob licença MIT. Aqui usamos cinco: ig-reel, ig-caption, ig-carousel, ig-profile e ig-dm.

Funciona sem o Claude Code?

Em parte. O README diz que, sem Claude Code, você cola um SKILL.md no começo de uma conversa e ele roda como um modo, mas perde as ferramentas Python, que são boa parte do valor do /ig-reel.

Posso ligar isso ao ManyChat?

O repositório não cita o ManyChat. A skill só escreve as mensagens. Quem envia é a ferramenta que você configurar, dentro das regras do Instagram.

Fontes oficiais

Próximos passos

Comece agora

Pronto para colocar 5 Skills pro Instagram no Claude para rodar?

Ver as skills no GitHub

Próximo passo

Veja os outros recursos do catálogo

Dezenas de recursos entre squads, skills, apps e integrações — todos usados em produção pelo João.

Voltar ao catálogo

Formação Gestor de IA

Aprenda a montar recursos como este, do zero

Quero ser Gestor de IA

Formação Gestor de IA

Falta um passo pro checkout

Deixa seu nome e WhatsApp. Você vai direto pro pagamento e a gente te acompanha de perto na entrada.

Com DDD. Só usamos pra te acompanhar na formação.