Skip to content
Back to search

conteudo-instagram-skill

Skill para Claude Code: do concorrente ao post agendado. Base de conhecimento do nicho, branding, carrosséis de conteúdo e produto, posts estáticos em PNG 1080x1350 — para qualquer nicho do Instagram.

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/spartamidiadf--conteudo-instagram-skill/badge.svg)](/listings/spartamidiadf--conteudo-instagram-skill)

HTML

<a href="/listings/spartamidiadf--conteudo-instagram-skill"><img src="/api/listings/spartamidiadf--conteudo-instagram-skill/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 · 306 lines
  1. # Conteúdo Instagram — skill para Claude Code
  2. **Um sistema completo de conteúdo para Instagram, para qualquer nicho e qualquer perfil.** Você junta os carrosséis que mais engajam no seu nicho e as referências visuais que você gosta; a skill transforma isso numa base de conhecimento do nicho e na identidade visual da sua marca, e passa a produzir **carrosséis de conteúdo, carrosséis de produto e posts estáticos** prontos para postar — com prévia por link, aprovação, exportação em PNG 1080×1350 com legenda e, se você quiser, agendamento.
  3. ![Exemplo de carrossel de conteúdo gerado pela skill (marca fictícia)](docs/exemplo-carrossel-conteudo.jpg)
  4. > Exemplo com uma marca fictícia ("Raiz Verde", nutrição). Cores, fontes, @ e avatar vêm de um único arquivo de configuração — a mesma skill produz para uma loja de moda, uma clínica, um infoproduto ou um sex shop.
  5. ---
  6. ## Sumário
  7. - [O que a skill faz](#o-que-a-skill-faz)
  8. - [Como funciona (visão geral)](#como-funciona-visão-geral)
  9. - [A pasta "Conteudo Instagram"](#a-pasta-conteudo-instagram)
  10. - [Instalação](#instalação)
  11. - [Primeiros passos](#primeiros-passos)
  12. - [As fases em detalhe](#as-fases-em-detalhe)
  13. - [Os três modelos de design](#os-três-modelos-de-design)
  14. - [Configuração da marca (`marca.json`)](#configuração-da-marca-marcajson)
  15. - [Scripts](#scripts)
  16. - [Agendamento (opcional)](#agendamento-opcional)
  17. - [Regras e cuidados embutidos](#regras-e-cuidados-embutidos)
  18. - [Requisitos e limitações](#requisitos-e-limitações)
  19. - [Origem](#origem)
  20. - [Licença](#licença)
  21. ---
  22. ## O que a skill faz
  23. | Etapa | O que você entrega | O que a skill produz |
  24. |---|---|---|
  25. | **Estrutura** | só pede para começar | a pasta `Conteudo Instagram` com 6 subpastas e instruções em cada uma |
  26. | **Base de conhecimento** | 50 a 100 carrosséis dos concorrentes (imagens) | transcrição de todos os slides (OCR) e a `BASE-CONHECIMENTO.md` do nicho: público, personas, dores com frases reais, pilares, **ganchos** que funcionam, **frameworks** de narrativa, CTAs, tom, padrões visuais, regras e um banco de 30 ganchos prontos |
  27. | **Branding e design** | referências visuais + foto do perfil | cores medidas nas referências, fontes encontradas por comparação, `marca.json` preenchido e `DESIGN.md` |
  28. | **Palavras-chave** (opcional) | exportação do Google Search Console | mapa de palavras-chave limpo (sem buscas de loja, erros de digitação ou termos vulgares), para os posts também aparecerem no Google |
  29. | **Carrossel de conteúdo** | um tema (ou nada — ela sugere) | ficha com 3 opções de capa, texto de cada slide, legenda com palavra-chave, texto alternativo, e a prévia visual por link |
  30. | **Carrossel de produto** | o nome do produto (lê a exportação da Shopify) | carrossel com dados reais do produto, fotos da loja **recortadas por IA** e o produto atravessando os slides (efeito panorama) |
  31. | **Post estático** | frases (suas ou de um banco) | posts de frase no padrão visual da marca, com legenda e crédito ao autor |
  32. | **Exportação** | a sua aprovação | PNGs 1080×1350 + `legenda.txt`, organizados em `6 - Conteudo Aprovado` |
  33. | **Agendamento** (opcional) | datas e horários | posts agendados no Instagram pelo SpartaGram |
  34. ---
  35. ## Como funciona (visão geral)
  36. ```mermaid
  37. flowchart LR
  38. A[Concorrentes<br/>50–100 carrosséis] --> B[OCR + análise]
  39. B --> C[BASE-CONHECIMENTO.md<br/>público · personas · ganchos · frameworks]
  40. D[Referências de design<br/>+ avatar] --> E[marca.json + DESIGN.md]
  41. F[Search Console<br/>opcional] --> G[Mapa de palavras-chave]
  42. C --> H[Ficha do post<br/>3 capas · slides · legenda]
  43. G --> H
  44. E --> I[Prévia HTML<br/>link para revisar]
  45. H --> I
  46. I -->|você aprova| J[PNG 1080×1350<br/>+ legenda.txt]
  47. J -->|opcional| K[Agendado no Instagram]
  48. ```
  49. A ordem de prioridade que a skill segue em toda peça:
  50. 1. **Base de conhecimento do nicho** — o que funciona com *este* público (vem dos concorrentes).
  51. 2. **Diretriz de branding** — cores, fontes, tom e regras da *sua* marca.
  52. 3. **Palavras-chave** — quais palavras escrever para também aparecer no Google.
  53. 4. **Biblioteca universal** — ganchos, frameworks e regras de escrita que valem para qualquer nicho.
  54. Nada é exportado nem agendado sem a sua aprovação.
  55. ---
  56. ## A pasta "Conteudo Instagram"
  57. ```
  58. Conteudo Instagram/
  59. ├── 1 - Referencia de Designer/ ← você: modelos visuais que quer seguir
  60. │ ├── Carrossel conteudo/
  61. │ ├── Carrossel produto/
  62. │ └── Post estatico/
  63. ├── 2 - Referencia de Concorrente/ ← você: 50–100 carrosséis do nicho (uma pasta por post)
  64. ├── 3 - Base de Conhecimento/ ← skill: TRANSCRICOES.md, BASE-CONHECIMENTO.md, DESIGN.md
  65. │ (opcional: palavras-chave.csv, produtos.csv, banco-frases.json)
  66. ├── 4 - Diretriz de Branding/ ← você + skill: marca.json, avatar.png
  67. ├── 5 - Conteudo Pre Aprovado/ ← skill: ficha .md + roteiro .spec.json + prévia .html
  68. └── 6 - Conteudo Aprovado/ ← skill, só depois da aprovação
  69. ├── 01 - Headline do carrossel/ (01.png, 02.png… + legenda.txt)
  70. └── Estaticos/ (E001 - frase.png + .txt)
  71. ```
  72. Cada pasta vem com um `LEIA-ME.md` explicando o que colocar nela.
  73. ---
  74. ## Instalação
  75. **Requisitos:** [Claude Code](https://claude.com/claude-code) e [Node.js](https://nodejs.org) 18 ou superior.
  76. ```bash
  77. # 1. Baixe o repositório
  78. git clone https://github.com/SpartaMidiaDF/conteudo-instagram-skill.git
  79. # 2. Copie a skill para a pasta de skills do Claude Code
  80. # macOS / Linux:
  81. cp -r conteudo-instagram-skill/skill ~/.claude/skills/conteudo-instagram
  82. # Windows (PowerShell):
  83. # Copy-Item -Recurse conteudo-instagram-skill\skill $HOME\.claude\skills\conteudo-instagram
  84. # 3. Instale as dependências dos scripts (Playwright + IA de recorte de fundo)
  85. cd ~/.claude/skills/conteudo-instagram/scripts
  86. npm install
  87. npx playwright install chromium
  88. ```
  89. Abra uma nova sessão do Claude Code. A skill aparece como `/conteudo-instagram` e também é acionada quando você pede coisas como "cria um carrossel", "analisa meus concorrentes" ou "faz um post de frase".
  90. ---
  91. ## Primeiros passos
  92. 1. **Crie a estrutura** — no Claude Code, na pasta onde quer guardar o conteúdo:
  93. > "Monta a estrutura de conteúdo do Instagram para a minha marca."
  94. 2. **Abasteça as pastas**
  95. - `2 - Referencia de Concorrente`: 50 a 100 carrosséis do seu nicho (uma subpasta por post, imagens em ordem).
  96. - `1 - Referencia de Designer`: prints de carrosséis e posts com o visual que você quer.
  97. - `4 - Diretriz de Branding`: `avatar.png` (a foto do perfil) e, se tiver, logo e paleta.
  98. 3. **Gere a base e a identidade**
  99. > "Analisa os concorrentes e cria a base de conhecimento."
  100. > "Monta o branding a partir das referências de design."
  101. 4. **Produza**
  102. > "Me traz 4 ideias de carrossel seguindo a base."
  103. > "Cria um carrossel do produto X." · "Faz 8 posts de frase."
  104. 5. **Aprove, exporte e (se quiser) agende**
  105. > "Aprovado, exporta." · "Agenda toda quarta às 12h a partir do dia 2."
  106. ---
  107. ## As fases em detalhe
  108. ### 1. Base de conhecimento do nicho
  109. - **Transcrição:** no Windows, OCR nativo do sistema (sem instalar nada) para todas as imagens; em macOS/Linux, `tesseract` ou leitura das imagens pelo próprio Claude.
  110. - **Leitura visual:** a skill monta folhas de contato das capas para entender o design dos concorrentes (o OCR não vê design).
  111. - **Análise:** a `BASE-CONHECIMENTO.md` segue um modelo de 15 seções (`skill/guia/MODELO-BASE.md`) — perfis analisados, público, personas, dores e frases reais, pilares, ganchos, frameworks, CTAs, linguagem, visual, adaptação para a marca, regras, banco de ganchos, checklist e índice de todos os posts analisados.
  112. ### 2. Branding e design
  113. - **Cores** medidas diretamente nas suas referências (pixel a pixel).
  114. - **Fontes** descobertas por comparação: a skill renderiza a mesma frase em várias fontes do Google e compara com a referência (`comparar-fontes.js`).
  115. - Resultado em `marca.json` (lido por todos os geradores) e `DESIGN.md`.
  116. ### 3. Carrossel de conteúdo
  117. Briefing (tema, persona, objetivo, framework), palavra-chave com a mesma intenção do post, **3 opções de capa** com ganchos diferentes, slides seguindo o framework escolhido, ficha completa (legenda, texto alternativo, observações), prévia renderizada e conferida antes de você ver.
  118. ### 4. Carrossel de produto
  119. Lê os dados reais da exportação de produtos da Shopify (só usa características que estão na descrição), baixa as fotos da loja, **remove o fundo com IA local** (sem internet, sem custo) e monta o carrossel panorama: problema → produto entrando → "Conheça o X" com etiquetas → benefícios → produto centralizado na divisa → "Primeira vez? 3 passos" → CTA.
  120. ### 5. Post estático de frase
  121. Frases suas, da base ou de um banco de frases; 1–2 palavras de destaque; fundo na cor da marca ou claro; a frase se ajusta sozinha ao espaço; legenda com crédito ao autor.
  122. ### 6. Exportação e agendamento
  123. PNGs 1080×1350 numerados e `legenda.txt` em `6 - Conteudo Aprovado`. Agendamento opcional (veja abaixo).
  124. ---
  125. ## Os três modelos de design
  126. | Modelo | Para quê | Como é |
  127. |---|---|---|
  128. | **Editorial** (`gerar-conteudo.js`) | carrossel de conteúdo | papel claro × fundo escuro, título serifado com destaque em itálico, anotação manuscrita com seta, slides em moldura de "app de notas", numeração 001/010 |
  129. | **Panorama** (`gerar-produto.js`) | carrossel de produto | fundo escuro, um slide claro de respiro, título pesado + texto itálico, etiquetas, foto recortada atravessando a divisa entre slides (vira um panorama ao deslizar), botão "Comente PALAVRA" |
  130. | **Estático** (`gerar-estatico.js`) | post de frase | fundo sólido (cor da marca ou claro), frase grande centralizada, destaque na cor escura, avatar + @ no rodapé |
  131. ![Exemplo de post estático (marca fictícia)](docs/exemplo-post-estatico.jpg)
  132. Todos os modelos leem cores, fontes, @, avatar e censura do `marca.json`. Se as suas referências pedirem outro layout, a skill adapta o CSS do gerador e registra a decisão no `DESIGN.md`.
  133. ### Galeria: estilos adaptados de referências
  134. Na Fase 2, a skill não fica presa aos três modelos: ela lê as referências de design que você colocou em `1 - Referencia de Designer` e adapta o layout à sua marca. Abaixo, seis carrosséis de **marcas fictícias** em nichos diferentes, cada um seguindo um modelo de referência (o código de todos está em [`exemplos/estilos/estilos.html`](exemplos/estilos/estilos.html), para servir de ponto de partida).
  135. **1. Notas em papel** — confeitaria: papel creme × vinho, título gigante em laranja, slides em moldura de app de notas.
  136. ![Estilo notas em papel](docs/estilo-notas-laranja.jpg)
  137. **2. Caramelo com cartões** — personal trainer: tons de caramelo, etiquetas sobre o título, cartão com foto e "Estrutura:" embaixo, assinatura manuscrita.
  138. ![Estilo caramelo com cartões](docs/estilo-caramelo-estrutura.jpg)
  139. **3. Minimalista com serifa** — odontologia: fundo cinza, uma ideia por slide, capa serifada com itálico e fechamento sobre foto.
  140. ![Estilo minimalista com serifa](docs/estilo-minimal-serifa.jpg)
  141. **4. Corporativo azul e amarelo** — contabilidade: azul-marinho, branco e amarelo, marca d'água de círculos, botões vermelhos e card de contato.
  142. ![Estilo corporativo azul e amarelo](docs/estilo-azul-amarelo.jpg)
  143. **5. Impacto em caixa alta** — corretor de imóveis: preto, cinza e laranja, títulos pesados em caixa alta, barra de temas no topo e @ no rodapé.
  144. ![Estilo impacto em caixa alta](docs/estilo-preto-laranja.jpg)
  145. **6. Esteira escura** — escola de inglês: começa no escuro, alterna com papel claro, notas numeradas e CTA "Comenta PALAVRA".
  146. ![Estilo esteira escura](docs/estilo-esteira-escura.jpg)
  147. Nos slides que pedem foto, os exemplos usam um degradê no lugar da imagem. No uso real, entram as fotos da marca.
  148. Exemplos prontos dos arquivos de entrada em [`exemplos/`](exemplos/): `marca.json`, `carrossel-conteudo.spec.json`, `carrossel-produto.spec.json` e `estaticos.json`.
  149. ---
  150. ## Configuração da marca (`marca.json`)
  151. ```json
  152. {
  153. "nome": "Raiz Verde",
  154. "arroba": "raizverde.nutri",
  155. "assinatura": "RAIZ VERDE",
  156. "nicho": "nutrição",
  157. "avatar": "avatar.png",
  158. "cores": {
  159. "claro": "#f3f1ea", "escuro": "#16302a", "acento": "#e0703a", "acento_claro": "#f08a55",
  160. "texto_escuro": "#16302a", "texto_claro": "#eef2ec",
  161. "estatico_fundo": "#2f6b57", "estatico_destaque": "#f3e7c9"
  162. },
  163. "fontes": {
  164. "titulo": "Fraunces", "texto": "Inter", "manuscrita": "Caveat",
  165. "produto_titulo": "Inter", "detalhe": "Quicksand", "estatico": "Fraunces"
  166. },
  167. "google_fonts": ["Fraunces:ital,wght@0,400;0,700;1,400", "Inter:wght@400;500;600;700;800", "Caveat:wght@500;700", "Quicksand:wght@400;500;600"],
  168. "tom": "amiga que entende do assunto, acolhedora, humor leve",
  169. "palavras_da_marca": [],
  170. "palavras_proibidas": [],
  171. "censura": [["dieta", "di.eta"]],
  172. "regras": ["Nunca inventar estatística, depoimento ou nome", "Sem promessa de resultado de saúde"]
  173. }
  174. ```
  175. | Campo | Para que serve |
  176. |---|---|
  177. | `nome`, `arroba`, `assinatura`, `inicial` | aparecem nos slides (topo, rodapé, logo); `inicial` é usada quando não há `avatar.png` |
  178. | `cores` | toda a paleta dos três modelos |
  179. | `fontes` + `google_fonts` | famílias e pesos carregados do Google Fonts |
  180. | `censura` | palavras sensíveis do nicho que saem "quebradas" nas imagens (ex.: nichos de saúde íntima, finanças com termos sensíveis) — a legenda continua por extenso para a busca |
  181. | `tom`, `palavras_da_marca`, `palavras_proibidas`, `regras` | lidos pela skill na hora de escrever |
  182. ---
  183. ## Scripts
  184. Todos em `skill/scripts/`, rodam de qualquer pasta dentro do projeto (ou com a variável `CONTEUDO_IG` apontando para a pasta `Conteudo Instagram`).
  185. | Script | O que faz |
  186. |---|---|
  187. | `iniciar.js [pasta]` | cria a estrutura `Conteudo Instagram` com LEIA-MEs e `marca.json` modelo |
  188. | `ocr.ps1 -Root … -Saida … [-Idioma pt-BR]` | (Windows) transcreve todos os carrosséis dos concorrentes |
  189. | `comparar-fontes.js "<frase>" saida.png "Fonte A" "Fonte B" …` | renderiza a frase em várias fontes para comparar com a referência |
  190. | `gerar-conteudo.js <spec.json>` | gera a prévia do carrossel de conteúdo (modelo editorial) |
  191. | `gerar-produto.js <spec.json>` | gera a prévia do carrossel de produto (modelo panorama) |
  192. | `gerar-estatico.js <lote.json>` | gera a prévia dos posts estáticos |
  193. | `produto.js "<nome>" [--fotos pasta]` | lê produto da exportação da Shopify e baixa as fotos |
  194. | `recorte.js <foto> <saida.png> [ia\|limite]` | remove o fundo da foto do produto (IA local por padrão) e apara |
  195. | `exportar.js <html> "<headline>"` | exporta o carrossel aprovado (PNGs + legenda.txt) |
  196. | `exportar-estatico.js <html>` | exporta os estáticos aprovados (PNG + .txt) |
  197. | `agendar.js "<post>" "AAAA-MM-DD HH:MM" …` | agenda no Instagram pelo SpartaGram (opcional) |
  198. O formato de cada `spec.json` está documentado no topo do script correspondente.
  199. ---
  200. ## Agendamento (opcional)
  201. A skill agenda posts usando o [SpartaGram](https://social.spartamidia.com) via MCP. Instale o conector com o seu token:
  202. ```bash
  203. claude mcp add --transport http --scope user spartagram https://social.spartamidia.com/mcp --header "Authorization: Bearer SEU_TOKEN"
  204. ```
  205. Depois é só pedir: *"Agenda os carrosséis 09 a 12 toda quarta às 12h a partir de 02/12."* A skill confere os agendamentos pendentes, sobe as imagens na ordem e agenda com a legenda. Sem o conector, todo o resto funciona normalmente — você posta os PNGs manualmente.
  206. ---
  207. ## Regras e cuidados embutidos
  208. - **Nada sem aprovação:** prévia por link → você aprova → só então exporta ou agenda.
  209. - **Nada inventado:** nenhuma estatística sem fonte, nenhum depoimento ou nome fictício, nenhum link inventado.
  210. - **Autoridade honesta:** a marca só fala como especialista se for; senão, a autoridade vem de fonte citada ou de especialista parceiro identificado.
  211. - **Sem texto com cara de IA:** lista de frases proibidas ("No mundo de hoje", "Vamos mergulhar"…), ritmo com frases curtas e reescrita da capa e do último slide.
  212. - **Direitos autorais:** letras de música ficam fora dos bancos de frases; frases de terceiros sempre com crédito.
  213. - **Produto sem promessa:** só características reais da descrição; alegações de saúde e promessas de resultado são cortadas.
  214. ---
  215. ## Requisitos e limitações
  216. - **Node.js 18+** e Chromium do Playwright (instalado no passo 3).
  217. - **OCR:** o script incluso usa o OCR nativo do **Windows** (precisa do pacote de idioma instalado). Em macOS/Linux, use `tesseract` ou deixe o Claude ler as imagens (mais lento para 100 posts).
  218. - **IA de recorte:** `@imgly/background-removal-node` (cerca de 130 MB, roda local). Licença AGPL — tranquilo para uso interno na produção de imagens; avalie se for redistribuir o software.
  219. - **Produtos:** o leitor entende a exportação de produtos da **Shopify**. Para outras plataformas, informe os dados do produto direto na conversa.
  220. - **Concorrentes:** a skill não baixa posts do Instagram — você coloca as imagens na pasta (há ferramentas de download de carrossel que salvam no formato esperado).
  221. ---
  222. ## Origem
  223. A skill nasceu de um projeto real: a análise de **122 carrosséis de 4 perfis de especialistas** de um nicho, que virou uma base de conhecimento, um mapa de palavras-chave do Search Console, dezenas de carrosséis e posts aprovados e agendados. Este repositório é a versão genérica desse processo — o método é o mesmo, só muda o nicho.
  224. ## Licença
  225. [MIT](LICENSE) — use, adapte e distribua à vontade. As dependências têm licenças próprias (Playwright: Apache-2.0; `@imgly/background-removal-node`: AGPL-3.0).

Ratings and comments

Sign in to rate this skill.

Sign in

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