Skip to content
Back to search

estudio-de-conteudo-ia

Kit open source de skills para criar, publicar e acompanhar conteúdo de Instagram com o seu agente de IA (Claude Code, Codex e outros).

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/fermaziero--estudio-de-conteudo-ia/badge.svg)](/listings/fermaziero--estudio-de-conteudo-ia)

HTML

<a href="/listings/fermaziero--estudio-de-conteudo-ia"><img src="/api/listings/fermaziero--estudio-de-conteudo-ia/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 211 lines
  1. <p align="center">
  2. <img src="docs/imagens/banner.png" alt="Estúdio de Conteúdo com IA: planeje, escreva, desenhe, publique e acompanhe seus posts do Instagram conversando com o seu agente de IA" width="100%">
  3. </p>
  4. <p align="center">
  5. <a href="https://github.com/fermaziero/estudio-de-conteudo-ia/actions/workflows/verificar.yml"><img src="https://github.com/fermaziero/estudio-de-conteudo-ia/actions/workflows/verificar.yml/badge.svg" alt="Verificação automática"></a>
  6. <img src="https://img.shields.io/badge/licen%C3%A7a-MIT-0f7b6c" alt="Licença MIT">
  7. <img src="https://img.shields.io/badge/python-3.10%2B-0f7b6c" alt="Python 3.10 ou mais novo">
  8. <img src="https://img.shields.io/badge/feito%20em-portugu%C3%AAs-0f7b6c" alt="Feito em português">
  9. </p>
  10. <p align="center">
  11. <b>Você conversa. A IA prepara. Você aprova.</b><br>
  12. Um kit de <i>skills</i> para o seu agente de IA criar, revisar, desenhar, publicar e acompanhar<br>
  13. o conteúdo do seu Instagram, do começo ao fim, em português.
  14. </p>
  15. <p align="center">
  16. <a href="#comece-em-5-passos">Comece agora</a> ·
  17. <a href="#veja-como-fica">Veja como fica</a> ·
  18. <a href="#como-funciona">Como funciona</a> ·
  19. <a href="#perguntas-frequentes">Perguntas frequentes</a>
  20. </p>
  21. ---
  22. **Skill** é um roteiro de trabalho que o seu agente de IA lê e segue. O agente é o assistente com quem você conversa no computador, como o Claude Code ou o Codex. Você pede em português ("o que eu posto essa semana?"), e ele sabe o caminho: o que perguntar, que arquivo criar, que script rodar e quando parar para pedir o seu ok.
  23. ## Por que usar
  24. - **Feito para a sua marca, não para uma marca genérica.** O agente entrevista você uma vez e passa a escrever no seu tom, com as suas regras e os seus limites.
  25. - **Artes sem erro de letra.** O texto é desenhado pelo código, na sua fonte e nas suas cores. A IA nunca escreve dentro de uma imagem nem redesenha um logo.
  26. - **Revisão de verdade.** Antes de você ler, outro agente confere fatos, clareza, português, as suas regras e os dados sensíveis. Se o seu agente não puder abrir outro, ele faz uma passagem separada e avisa.
  27. - **Nada vai ao ar sem você.** A aprovação final pede o seu clique numa janela do seu computador.
  28. - **Aprende com você.** Todo "não gostei" vira regra registrada, e o painel mostra o que funcionou para planejar os próximos posts.
  29. ## Veja como fica
  30. Tudo abaixo saiu do kit, usando a **Exemplo Contábil**, uma marca fictícia que vem junto para você testar antes de configurar a sua.
  31. ### Um carrossel gerado pelo kit
  32. ![Seis dos sete slides de um carrossel da marca fictícia Exemplo Contábil sobre separar a conta da empresa da conta pessoal: capa escura com a pergunta, slides claros com texto, cartões, lista de passos e citação, e o último slide com a chamada para salvar o post. O slide 6, que pede uma imagem, ainda não foi gerado](docs/imagens/exemplo-carrossel.png)
  33. O texto foi escrito a partir de uma pauta aprovada e passou pela revisão independente. As artes foram desenhadas com as cores e o logo da marca. O slide 6 pede uma ilustração, que você cria na sua ferramenta de imagem e o kit encaixa; como ela ainda não existe no exemplo, o slide ficou fora da montagem.
  34. ### A galeria para você aprovar
  35. ![Galeria de aprovação do lote de exemplo, com os slides lado a lado, a legenda pronta para copiar, a chamada para ação, uma pendência que bloqueia a publicação e um aviso sobre uma imagem que falta](docs/imagens/galeria.png)
  36. Cada lote (o conjunto de posts feitos juntos, em geral os da semana) ganha uma página com as artes, a legenda e o que ainda falta resolver. Um post com fato não conferido fica bloqueado até alguém confirmar a fonte.
  37. ### O painel de resultados
  38. ![Painel de resultados da marca fictícia, com pontos de atenção, seguidores, posts por semana, alcance médio, interação e metas com o ritmo necessário até o prazo](docs/imagens/painel.png)
  39. O painel compara metas, ritmo de publicação e desempenho por tema, formato e etapa do funil (atrair, criar relação ou vender), e diz o que olhar primeiro. Quando falta um dado, aparece "não medido", nunca um zero inventado.
  40. ## Como funciona
  41. ```mermaid
  42. flowchart LR
  43. subgraph P["Preparar"]
  44. direction TB
  45. A["Configurar a marca"] --> B["Pesquisar referências"] --> C["Planejar as pautas"]
  46. end
  47. subgraph Q["Produzir"]
  48. direction TB
  49. D["Escrever os posts"] --> E["Revisão independente"] --> F(["Você aprova o texto"]) --> G["Gerar as artes"] --> H(["Você aprova a versão final"])
  50. end
  51. subgraph R["Publicar e aprender"]
  52. direction TB
  53. I["Publicar ou agendar"] --> J["Acompanhar os resultados"]
  54. end
  55. P --> Q --> R
  56. ```
  57. O que funcionou volta para o planejamento do próximo lote, e cada ajuste que você pede vira regra da marca.
  58. | Você diz ao agente | Skill que entra em ação | O que você recebe |
  59. |---|---|---|
  60. | "Quero configurar minha marca" | `configurar-marca` | A ficha da marca: quem é, tom de voz, regras, visual e metas |
  61. | "Analisa esse perfil de referência" | `pesquisar-referencias` | O que funciona no perfil, comparado com o seu |
  62. | "O que eu posto essa semana?" | `planejar-conteudo` | Pautas (ideias de post) com a frase da capa, o formato e o objetivo, para você aprovar |
  63. | "Escreve o carrossel da pauta 2" | `criar-conteudo` | Slides, legenda e chamada para ação, texto primeiro |
  64. | "Revisa esse post" | `revisar-conteudo` | Um parecer: aprovar, ajustar ou refazer, com o porquê |
  65. | "Gera as artes" | `gerar-artes` | As imagens do post e a galeria de aprovação |
  66. | "Pode publicar" ou "agenda para quinta às 18h" | `publicar-instagram` | O post no ar ou agendado, e o link para conferir |
  67. | "Como estão meus resultados?" | `acompanhar-resultados` | O painel, a leitura do que funcionou e o ajuste das metas |
  68. ## Comece em 5 passos
  69. 1. **Instale o Python e um agente de IA.** O guia para quem nunca fez isso, no Windows e no macOS, está em [docs/primeiros-passos.md](docs/primeiros-passos.md).
  70. 2. **Baixe o projeto.** Nesta página, clique em **Code** e depois em **Download ZIP**, e extraia a pasta. Quem usa git pode fazer `git clone`.
  71. 3. **Abra a pasta no seu agente de IA.** Tem de ser a pasta que contém `AGENTS.md`, `skills/` e `marcas/`.
  72. 4. **Instale o Pillow**, a biblioteca que desenha as artes. Peça ao agente ("instale o que falta para o estúdio funcionar") ou rode `python -m pip install -r requirements.txt` (no macOS e no Linux, `python3`). Se aparecer "externally-managed-environment", siga o guia de primeiros passos.
  73. 5. **Diga: "Quero configurar minha marca."** O agente faz poucas perguntas por vez e monta a sua ficha em `marcas/<sua-marca>/`. Para ver um resultado antes, peça: "Mostre a marca de exemplo".
  74. Depois, é só conversar.
  75. ## O que você precisa
  76. | Item | Para quê |
  77. |---|---|
  78. | Computador com Windows, macOS ou Linux | O guia passo a passo cobre Windows e macOS |
  79. | Um agente de IA que leia o `AGENTS.md` (Claude Code, Codex, Cursor, Gemini CLI e outros) | É com ele que você conversa; em geral exige conta, e alguns pedem plano pago |
  80. | Python 3.10 ou mais novo e o Pillow | Rodam os scripts e desenham as artes |
  81. | Conta **profissional** do Instagram, um app na Meta e um *bucket* (espaço de armazenamento na nuvem) para as imagens | Só para publicar e ler os números: [docs/instagram-api.md](docs/instagram-api.md) e [docs/armazenamento-imagens.md](docs/armazenamento-imagens.md) |
  82. | Chrome com o Instagram logado e uma extensão que deixe o agente ler a página | Só para pesquisar perfis de referência |
  83. > **Publicar é a parte que mais dá trabalho para configurar.** Criar o app na Meta e o *bucket* (onde as imagens ficam por alguns minutos na hora de publicar) leva cerca de 1 hora na primeira vez, e o serviço de armazenamento pode pedir um cartão para ativar a conta. **O resto do kit funciona sem isso:** você planeja, escreve, revisa, gera as artes e publica à mão, se preferir.
  84. ## Segurança e privacidade
  85. - **Seus arquivos ficam no seu computador.** Tudo da sua marca fica em `marcas/`, que o git do projeto ignora (só a marca fictícia `exemplo` é versionada). Atualizar o projeto não mexe nas suas marcas.
  86. - **Credenciais ficam fora do projeto,** em `~/.config/estudio-de-conteudo/<marca>/`. Você cola o token do Instagram (a "senha de máquina" que deixa o programa publicar sem a sua senha) numa janela que abre no seu computador, nunca no chat. Colou no chat sem querer? Trate como vazado e gere outro.
  87. - **A aprovação final é sua.** Quando você diz "pode publicar" e o código do post, o agente confere tudo e abre uma janela com o resumo do post: a aprovação só é gravada se você clicar em **Aprovar**. Depois do clique, o programa assina a aprovação com uma chave secreta guardada fora do projeto. Editar o arquivo do post à mão não aprova nada, e qualquer mudança no texto ou nas artes cancela o ok.
  88. - **Limite honesto:** quem controla o computador inteiro (um agente que clica na tela por você, por exemplo) ainda poderia contornar essas travas. As regras do projeto proíbem; se o seu agente controla a tela, não deixe que ele clique por você.
  89. - **A IA que você usa lê os seus arquivos,** conforme a política de privacidade do serviço dela. Dados de clientes, alunos ou menores só entram com autorização registrada em `regras.md`, em linha com a LGPD.
  90. - **A pesquisa de referências só lê.** Não curte, não segue, não comenta. A Meta proíbe coleta automatizada sem permissão escrita dela, e o Instagram pode limitar a sua conta: a skill avisa antes de começar e só segue com o seu ok.
  91. - **Achou uma falha de segurança?** Relate pelo caminho descrito em [SECURITY.md](SECURITY.md).
  92. A cada envio ao repositório, uma [verificação automática](.github/workflows/verificar.yml) roda no Windows, no macOS e no Linux, com Python 3.10 e 3.13: procura segredos, valida o exemplo e roda os autotestes. Antes de compartilhar a sua cópia, rode `python -X utf8 ferramentas/checar_segredos.py`.
  93. ## Perguntas frequentes
  94. <details>
  95. <summary><b>Preciso saber programar?</b></summary>
  96. Não. Você conversa em português com o agente, e ele roda os comandos. Na primeira vez, você instala o Python e o agente seguindo o [guia de primeiros passos](docs/primeiros-passos.md). Quando o agente pedir permissão para rodar um comando, ele explica antes o que o comando faz.
  97. </details>
  98. <details>
  99. <summary><b>Funciona com qual IA?</b></summary>
  100. Com agentes que trabalham numa pasta do seu computador: Claude Code, Codex, Cursor, Gemini CLI e outros. Claude Code, Codex e Cursor leem o `AGENTS.md` sozinhos; no Gemini CLI, peça "leia o AGENTS.md". Todos acham as skills pelos atalhos que vêm no projeto.
  101. </details>
  102. <details>
  103. <summary><b>Quanto custa?</b></summary>
  104. O kit é gratuito e aberto (licença MIT). Os custos possíveis são de fora: a assinatura do seu agente de IA e, se você publicar pelo kit, o armazenamento de imagens (o [guia](docs/armazenamento-imagens.md) explica).
  105. </details>
  106. <details>
  107. <summary><b>Ele publica sozinho?</b></summary>
  108. Só o que você aprovou. Para agendar, você instala uma rotina no seu computador uma vez (o agente mostra o comando, e quem roda é você). Ela publica no horário com o computador ligado e a sua sessão aberta. Se o computador voltar em até 2 horas depois do horário, o post ainda sai; passado isso, nada é publicado e fica registrado.
  109. </details>
  110. <details>
  111. <summary><b>Publica Reels e Stories?</b></summary>
  112. Ainda não. Nesta versão, o kit publica carrossel e imagem única no feed. Para reel, ele escreve o roteiro, e você grava e posta.
  113. </details>
  114. <details>
  115. <summary><b>Posso ter mais de uma marca?</b></summary>
  116. Sim. Cada marca tem a sua pasta em `marcas/`, com regras, visual, conteúdo e credenciais separados.
  117. </details>
  118. <details>
  119. <summary><b>E se o Instagram mudar alguma coisa?</b></summary>
  120. As APIs (as portas oficiais pelas quais os programas conversam com o Instagram) mudam de tempos em tempos. Os guias registram a data em que cada informação foi conferida na documentação oficial. Se algo parar de funcionar, abra uma *issue* (um aviso de problema) neste repositório.
  121. </details>
  122. ## Documentação
  123. | Guia | Para quem | O que tem |
  124. |---|---|---|
  125. | [Primeiros passos](docs/primeiros-passos.md) | Você | Instalar tudo e fazer a primeira conversa |
  126. | [Conectar o Instagram](docs/instagram-api.md) | Você | App na Meta, permissões e token (só para publicar e ler números) |
  127. | [Armazenamento de imagens](docs/armazenamento-imagens.md) | Você | O *bucket* onde as imagens ficam por alguns minutos na hora de publicar |
  128. | [AGENTS.md](AGENTS.md) | O seu agente de IA | O manual que ele segue: fluxo, regras e comandos |
  129. | [Arquitetura](docs/arquitetura.md) | Quem quer contribuir | O contrato entre as skills: pastas, formatos e regras |
  130. <details>
  131. <summary><b>Estrutura das pastas</b></summary>
  132. ```
  133. estudio-de-conteudo-ia/
  134. ├── AGENTS.md manual do agente de IA (vale para qualquer agente)
  135. ├── CLAUDE.md complemento para o Claude Code
  136. ├── SECURITY.md como relatar uma falha e como o projeto se protege
  137. ├── docs/ guias passo a passo, imagens e o contrato entre as skills
  138. ├── skills/ as 8 skills (SKILL.md, scripts, referências e modelos)
  139. ├── ferramentas/ sincronizar os atalhos das skills e checar segredos
  140. ├── .github/ verificação automática
  141. └── marcas/ os seus dados (fora do git) e a marca de exemplo
  142. ```
  143. As pastas `.claude/skills/` e `.agents/skills/` guardam atalhos gerados para o Claude Code e o Codex acharem as skills. Não edite à mão.
  144. </details>
  145. <details>
  146. <summary><b>Atualizar o projeto</b></summary>
  147. Com `git clone`, rode `git pull` na pasta do projeto. Com o ZIP, baixe o novo, extraia em outra pasta e copie para lá a sua pasta `marcas/<sua-marca>`.
  148. Se você instalou a rotina de agendamento, ela guarda o caminho da pasta antiga e continua rodando de lá. Na pasta antiga, rode `python -X utf8 skills/publicar-instagram/scripts/rotina.py remover --marca <sua-marca>` e, na nova, `python -X utf8 skills/publicar-instagram/scripts/rotina.py instalar --marca <sua-marca>` (no macOS e no Linux, `python3`). Quem roda esses dois comandos é você, não o agente.
  149. </details>
  150. ## Créditos
  151. Criado por Fernando Maziero para os mentorados da Mentoria 1Advisor.
  152. ## Licença
  153. O código é [MIT](LICENSE): você pode usar, adaptar e compartilhar, mantendo o aviso de autoria. **Exceção:** as fontes em `skills/gerar-artes/fontes/` (Manrope) têm licença própria, a SIL Open Font License 1.1 ([detalhes](skills/gerar-artes/fontes/LEIA-ME.md)). Os nomes de produtos citados (Instagram, Meta, Claude, Codex, Cursor, Gemini e outros) pertencem aos seus donos; este projeto é independente e não tem vínculo com eles.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.