Primeiro baixe o repositório. Depois siga a instalação correspondente.
Claude Code CodexEscolha seu caminho.
Este guia instala as 13 pastas originais do repositório. Você não precisa conectar sua conta do Instagram.
Prepare o computador
Tenha Claude Code ou Codex instalado e conectado à sua conta. Os comandos deste guia usam o Windows PowerShell; a seção “macOS e Linux” traz equivalentes para macOS e Linux.
Baixe uma única vez
Siga a seção “Baixar o repositório” com Git ou a seção “Alternativa sem Git” sem Git. Depois siga apenas a instalação da ferramenta que você usa.
Plugin do autor: seção “Alternativa por plugin”CodexPastas locais: seções de instalação e teste no Codex
Sem comandos /plugin
Configurar o Claude Code · Documentação do Codex · Instalar Git
Baixe o repositório com Git.
Abra o PowerShell
No menu Iniciar do Windows, procure “PowerShell” e abra. Cole os blocos abaixo no terminal, não na conversa com a IA.
git --version
Se aparecer uma versão do Git, continue. Se o comando não existir, instale pelo link da seção “Antes de começar” e abra um novo PowerShell, ou siga a seção “Alternativa sem Git”.
Crie sua pasta e baixe os arquivos
Use uma pasta nova chamada instagram-conteudo. Se ela já existir, escolha outro nome para não misturar projetos.
Set-Location $HOME New-Item -ItemType Directory instagram-conteudo Set-Location ./instagram-conteudo git clone https://github.com/Jakeschincariol/instagram-agent-skill.git instagram-agent-skill-original git -C ./instagram-agent-skill-original checkout d03c56bb598be770c60b201f94237e5d1a4268a6
Sem Git? Baixe o ZIP.
Abra o repositório no navegador
Acesse github.com/Jakeschincariol/instagram-agent-skill. Clique no botão Code e depois em Download ZIP. O repositório público pode ser baixado sem login.
Extraia o arquivo
No Explorador de Arquivos, clique com o botão direito no ZIP e escolha “Extrair Tudo”. Renomeie a pasta extraída para instagram-agent-skill-original. Não copie o ZIP ainda fechado.
Organize as pastas
Crie instagram-conteudo e coloque a pasta renomeada dentro dela. Abra instagram-conteudo no Explorador, digite powershell na barra de endereços e pressione Enter.
instagram-conteudo/
instagram-agent-skill-original/
LICENSE
README.md
templates/
skills/
ig-reel/SKILL.md
ig-caption/SKILL.md
...Para baixar exatamente a versão deste guia, use este ZIP do commit fixado. “Download ZIP” da página principal pode trazer uma versão mais recente.
Claude Code: instale no projeto.
Método principal: copiar as pastas originais para .claude/skills/. As skills ficam disponíveis neste projeto; você não altera as skills pessoais de outros trabalhos.
Confira o diretório atual
O PowerShell precisa estar na pasta que contém instagram-agent-skill-original. Se usou a seção “Baixar o repositório”, você já está em instagram-conteudo.
Test-Path ./instagram-agent-skill-original/skills/ig-reel/SKILL.md
O resultado precisa ser True. Se aparecer False, volte à estrutura da seção “Alternativa sem Git”.
Copie as 13 pastas completas
Cole o bloco inteiro. Ele interrompe se encontrar uma pasta de mesmo nome, em vez de sobrescrever sua instalação.
$destino = '.claude/skills'
New-Item -ItemType Directory -Force $destino | Out-Null
$skills = Get-ChildItem './instagram-agent-skill-original/skills' -Directory
$repetidas = $skills | Where-Object {
Test-Path (Join-Path $destino $_.Name)
}
if ($repetidas) { throw 'Já existem skills nesse destino. Revise antes de copiar.' }
$skills | ForEach-Object {
Copy-Item -LiteralPath $_.FullName -Destination $destino -Recurse
}Claude Code: confira e teste.
Conte as skills instaladas
No mesmo PowerShell, execute:
(Get-ChildItem ./.claude/skills/ig-*/SKILL.md).Count
Resultado esperado nesta versão: 13.
Abra o Claude Code nessa pasta
No aplicativo, abra a pasta instagram-conteudo (ou a pasta principal do kit). Se você usa o terminal e o CLI já está instalado, execute:
claude
Chame uma skill
Na conversa do Claude Code, digite / e procure ig-reel. Na instalação por pastas, o comando é /ig-reel. Envie:
/ig-reel Crie um roteiro de 30 segundos sobre como dar contexto à IA. Responda em português. Entregue 3 ganchos, fala, cenas e textos na tela. Não publique nada.
Claude Code: alternativa por plugin.
Esta é a opção de plugin oferecida pelo autor. Escolha este método ou o de pastas das seções de instalação e teste no Claude Code, para evitar duas cópias da mesma skill no seletor.
Adicione o catálogo do autor
Dentro de uma conversa do Claude Code, envie:
/plugin marketplace add Jakeschincariol/instagram-agent-skill
Instale o plugin do catálogo
O nome do plugin é instagram-agent; o catálogo chama-se instagram-agent-skill.
/plugin install instagram-agent@instagram-agent-skill
Escolha o escopo mostrado na sua versão. Escopo de usuário vale para seus projetos nesta máquina; escopo de projeto se aplica àquele projeto. Leia o que o instalador mostra antes de confirmar.
Confira os comandos disponíveis
Abra /plugin e confirme que o plugin está habilitado. Digite / e procure ig-reel; plugins podem mostrar o prefixo do plugin, como instagram-agent:ig-reel. Use o nome exibido no seu menu.
Codex: instale no projeto.
O repositório foi escrito para Claude Code. No Codex, vamos instalar as pastas de skills, preservando seus arquivos originais. Isso não converte o plugin nem garante que toda instrução específica do Claude tenha o mesmo comportamento.
Abra o PowerShell na pasta de trabalho
Use a mesma pasta instagram-conteudo da seção “Baixar o repositório” ou a pasta principal do kit, que contém instagram-agent-skill-original.
Test-Path ./instagram-agent-skill-original/skills/ig-reel/SKILL.md
Continue se o resultado for True.
Copie para .agents/skills
Cole o bloco inteiro. A pasta correta é .agents, com ponto no início e s no final.
$destino = '.agents/skills'
New-Item -ItemType Directory -Force $destino | Out-Null
$skills = Get-ChildItem './instagram-agent-skill-original/skills' -Directory
$repetidas = $skills | Where-Object {
Test-Path (Join-Path $destino $_.Name)
}
if ($repetidas) { throw 'Já existem skills nesse destino. Revise antes de copiar.' }
$skills | ForEach-Object {
Copy-Item -LiteralPath $_.FullName -Destination $destino -Recurse
}Codex: confirme que carregou.
Conte as pastas instaladas
No mesmo PowerShell:
(Get-ChildItem ./.agents/skills/ig-*/SKILL.md).Count
Resultado esperado: 13.
Abra o projeto no Codex
Abra a pasta instagram-conteudo no aplicativo ou extensão. Se você usa o CLI e já o instalou, execute codex a partir dessa pasta. Inicie uma conversa nesse projeto.
Peça a leitura e o primeiro roteiro
Você pode procurar ig-reel no seletor de skills da sua versão. Para confirmar o arquivo exato, envie:
Use a skill ig-reel. Primeiro leia .agents/skills/ig-reel/SKILL.md e informe o caminho que leu. Depois crie 3 ganchos e um roteiro de 30 segundos sobre dar contexto à IA, em português. Inclua fala, cenas e texto na tela. Não publique nada.
Dê a sua voz às skills.
A instalação organiza as instruções. O seu contexto é o que permite adaptar a entrega. O projeto original procura um arquivo de voz em ~/.claude/instagram/voice.md, inclusive em instruções que você pode ler pelo Codex.
Crie um contexto dentro do seu projeto
Para começar sem mexer na pasta pessoal, copie o modelo original para a pasta de trabalho:
if (Test-Path ./voice.md) { throw 'voice.md já existe. Edite o arquivo atual.' }
Copy-Item ./instagram-agent-skill-original/templates/voice.md ./voice.mdPreencha o arquivo
Abra voice.md em um editor. Informe quem você ajuda, sobre o que fala, o que oferece, como escreve e três textos reais seus. Substitua os exemplos do modelo pelos seus fatos.
Meu público: donos de negócios que querem aplicar IA. Meu tema: automação e aquisição de clientes. Meu tom: direto, prático, em português. Não invente faturamento, clientes ou resultados. Meus exemplos reais: [cole três textos seus].
Peça a leitura explicitamente
No início do pedido, escreva: “Leia voice.md desta pasta como contexto de voz, mesmo que a skill mencione outro caminho.” Assim você indica qual perfil usar.
Seu primeiro pedido completo.
Depois de confirmar a instalação e preencher voice.md, cole o pedido abaixo. No Claude Code, você pode começar com /ig-reel; no Codex, selecione a skill ou mencione ig-reel pelo nome.
Use a skill ig-reel instalada neste projeto. Leia voice.md desta pasta como meu contexto. Responda em português do Brasil. Tema: como dar contexto à IA antes de pedir um post. Público: donos de pequenos negócios. Objetivo: ensinar uma aplicação simples. Duração: 30 segundos. CTA: comentar INSTAGRAM para receber este kit. Entregue 3 ganchos diferentes e explique a escolha. Desenvolva o roteiro com fala, cenas, texto na tela e duração aproximada de cada trecho. Não invente resultados, métricas ou clientes. Se executar scripts, mostre quais rodou. Não publique nem envie mensagens por mim.
Como avaliar a resposta
Procure três ganchos, um roteiro com cenas e um CTA único. Confira se a IA respeitou sua voz e separou fatos de exemplos. Ajuste o tema e peça uma revisão concreta, como “encurte a abertura e acrescente uma demonstração na segunda cena”.
Teste os scripts com Python.
As instruções podem ser lidas sem Python. Para usar os verificadores originais, é necessário Python 3 disponível no mesmo ambiente onde a ferramenta executa comandos.
Confira o Python no Windows
Abra o PowerShell na pasta de trabalho:
python --version
Se python não existir, teste py -3 --version. Se nenhum funcionar, instale Python pelo site oficial, reabra o terminal e confira novamente.
Execute um teste independente da IA
O comando usa o script original do repositório baixado:
python ./instagram-agent-skill-original/skills/ig-reel/hookscore.py --hook "Antes de pedir um post, mostre à IA como você fala."
Se sua instalação usa o launcher do Windows, substitua python por py -3.
macOS e Linux: comandos equivalentes.
Use esta seção no lugar dos blocos PowerShell. Abra o Terminal e baixe o mesmo repositório:
mkdir "$HOME/instagram-conteudo" cd "$HOME/instagram-conteudo" git clone https://github.com/Jakeschincariol/instagram-agent-skill.git instagram-agent-skill-original git -C instagram-agent-skill-original checkout d03c56bb598be770c60b201f94237e5d1a4268a6
Claude Code
mkdir -p .claude/skills
for origem in instagram-agent-skill-original/skills/ig-*; do
destino=".claude/skills/$(basename "$origem")"
if [ -e "$destino" ]; then
echo "Já existe: $destino. Revise antes de copiar."
else
cp -R "$origem" "$destino"
fi
doneCodex
Use o mesmo laço acima, trocando as duas ocorrências de .claude/skills por .agents/skills. Depois abra a pasta no Codex e siga a conferência da seção “Testar no Codex”.
Se algo não funcionar.
“git não é reconhecido”
O Git não está disponível nesse terminal. Instale, abra um terminal novo e rode git --version. Ou siga o download de ZIP da seção “Alternativa sem Git”.
Test-Path retornou False
Você está na pasta errada ou extraiu o ZIP com uma pasta a mais. A pasta atual precisa conter instagram-agent-skill-original/skills/ig-reel/SKILL.md.
A cópia parou porque já existe uma skill
Isso protege a instalação atual. Use uma pasta de projeto nova para testar este kit. Não acrescente -Force para apagar a dúvida.
A skill não aparece no aplicativo
Confira .claude/skills no Claude Code e .agents/skills no Codex. Abra a pasta do projeto, não apenas a subpasta do repositório baixado. Reabra a sessão se necessário.
O plugin usa outro nome no menu
No Claude Code, abra /plugin e confira se instagram-agent está habilitado. Use o comando com o prefixo exibido pela sua versão. No Codex, siga a instalação por pastas.
O script funciona no terminal, mas a IA não executa
O ambiente ou as permissões da conversa podem ser diferentes. Informe o caminho do script e o interpretador que funcionou. Não considere a execução confirmada sem saída ou registro da ação.
A resposta saiu em inglês ou ficou genérica
Peça português explicitamente e indique voice.md no pedido. Envie exemplos seus; instalar a skill não fornece seu público e sua voz automaticamente.
Confirme antes de usar.
Os arquivos estão no lugar
Em uma pasta nova, há 13 arquivos ig-*/SKILL.md no destino da ferramenta. Os scripts e JSONs foram copiados junto.
A ferramenta leu a skill
O menu ou as ações da conversa identificam o arquivo utilizado. Você recebeu um primeiro rascunho e revisou o resultado.
Seu contexto está preenchido
voice.md contém fatos e exemplos seus. Você pediu sua leitura explicitamente e informou público, tema e objetivo.
Você sabe o que foi executado
Leitura de instruções e execução de Python são verificações distintas. Scripts só foram executados se houver uma ação e uma saída correspondentes.
Atualizar ou remover depois
Para atualizar, baixe a nova versão em outra pasta, compare as mudanças e teste antes de substituir as 13 pastas instaladas. Preserve voice.md e seus próprios arquivos. O commit fixado não recebe novidades automaticamente.
Para desinstalar a cópia local, remova pelo Explorador apenas as pastas ig-* que você instalou dentro de .claude/skills ou .agents/skills. Não remova outras skills. Para o plugin do Claude Code, use /plugin e a opção de desinstalar.
Origem, versão e limites.
O código continua sendo do autor
Instagram Agent Skill, de Jake Schincariol, licença MIT. O pacote mantém os arquivos originais e a licença. Este guia em português, a organização e os prompts de uso são de Weslley Alves / Método MAC.
d03c56bb598be770c60b201f94237e5d1a4268a6
Os caminhos de instalação foram conferidos na documentação e os comandos de cópia foram testados em pastas temporárias. O script hookscore.py foi executado localmente. Não foi feito um teste de ativação completo em contas novas do Claude Code e do Codex; versões e políticas do ambiente podem mudar o menu e as permissões.
Fontes para consultar
- Repositório e instruções originais
- Licença MIT da versão distribuída
- Claude Code: skills e pastas locais
- Claude Code: instalação de plugins
- Codex: localização das skills
Conferência editorial: 23 de outubro de 2026. Skills gratuitas; ferramenta de IA, pesquisa, geração de mídia e serviços externos podem exigir recursos próprios.