Skip to content
Back to search

plugin-imagens-claude-code

MarketplaceWorks with Claude CodeGitHub

Plugin do Claude Code: o Claude gera imagens escrevendo código que desenha (SVG, canvas, WebGL), olha o resultado, dá nota e refaz. Sem gerador externo.

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/marco3079--plugin-imagens-claude-code/badge.svg)](/listings/marco3079--plugin-imagens-claude-code)

HTML

<a href="/listings/marco3079--plugin-imagens-claude-code"><img src="/api/listings/marco3079--plugin-imagens-claude-code/badge.svg" alt="findsafeskills safety rating" /></a>

Install

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.

.claude-plugin/marketplace.json · Manifest · 11 lines
  1. {
  2. "name": "plugin-imagens-claude-code",
  3. "owner": { "name": "marco3079" },
  4. "plugins": [
  5. {
  6. "name": "imagens",
  7. "source": "./",
  8. "description": "O Claude gera imagens escrevendo código que desenha, olhando o resultado e refazendo. Sem gerador externo."
  9. }
  10. ]
  11. }
README.md · README · 192 lines
  1. # plugin-imagens-claude-code
  2. Plugin do Claude Code que faz o Claude ficar bom em gerar imagens **sem gerador externo**. Nada de API de
  3. imagem nem Canva: o Claude escreve código que desenha, renderiza no navegador que já está na sua
  4. máquina, **abre o resultado, dá nota e refaz** até ficar bom. Para animal peludo realista ele usa o Blender,
  5. se estiver instalado, também só por script.
  6. ![Do pedido à imagem em oito passos](exemplos/infografico/infografico.png)
  7. ## O limite honesto
  8. Código não iguala um modelo de difusão em **fotorrealismo de pessoas, rostos, animais e cenas complexas**.
  9. Se você pedir a foto de uma pessoa na rua, o plugin vai dizer isso e oferecer o que faz bem:
  10. - cena renderizada de objetos e ambientes simples (produto, natureza-morta);
  11. - realismo estilizado e ilustração;
  12. - logo, ícone, marca, telas, diagramas e infográficos, onde código costuma ganhar de difusão em precisão e em texto correto;
  13. - edição e restauração de uma imagem que já existe, dentro do que dá para fazer com operações em pixels.
  14. O que sai do caminho "foto realista" é um **render**. De perto, parece render.
  15. ## Instalar
  16. ```
  17. /plugin marketplace add marco3079/plugin-imagens-claude-code
  18. /plugin install imagens@plugin-imagens-claude-code
  19. ```
  20. Para testar a partir de uma cópia local do repositório, troque a primeira linha pelo caminho da pasta:
  21. ```
  22. /plugin marketplace add /caminho/para/plugin-imagens-claude-code
  23. /plugin install imagens@plugin-imagens-claude-code
  24. ```
  25. ### Requisitos
  26. - **Node 18 ou mais novo.** Os scripts não têm dependências: nada de `npm install`.
  27. - **Microsoft Edge, Google Chrome ou Chromium** instalado. No Windows o Edge já vem. O navegador roda sem janela.
  28. - Para o caminho de cena realista, uma placa de vídeo ajuda muito. Sem placa funciona, bem mais devagar.
  29. Se o navegador estiver num lugar fora do padrão, defina `IMAGENS_NAVEGADOR` com o caminho do executável.
  30. Para conferir o ambiente:
  31. ```bash
  32. node scripts/renderizar.mjs --diagnostico
  33. ```
  34. ## Usar
  35. Peça uma imagem em conversa normal ("desenha um logo para a minha padaria", "faz um infográfico sobre X",
  36. "restaura esta foto") e a skill entra sozinha. Ou use os comandos:
  37. | Comando | O que faz |
  38. |---|---|
  39. | `/imagem <pedido>` | Roda o fluxo completo para o pedido |
  40. | `/imagem-editar <arquivo> <o que fazer>` | Edita ou restaura uma imagem, preservando o original |
  41. | `/imagem-estilo [listar, mostrar, salvar]` | Lista, mostra e salva estilos |
  42. | `/imagem-ficha [listar, criar, usar]` | Cria ou usa uma ficha de personagem ou de marca |
  43. As imagens saem em `imagens/<nome-curto>/` no seu projeto: o arquivo final, a folha de contato com as
  44. variações e o código-fonte, para você pedir ajustes ("deixa o céu mais roxo") sem começar do zero.
  45. ## Como funciona
  46. 1. **Entender.** Se o pedido estiver vago, até quatro perguntas: assunto, uso e tamanho, estilo, o que não pode ter.
  47. 2. **Escolher a técnica** entre cinco (tabela abaixo).
  48. 3. **Especificar** antes de programar: composição, ponto focal, paleta com hex, luz, materiais, tipografia, o que evitar.
  49. 4. **Variar.** Três ou quatro versões que diferem em composição, paleta ou luz.
  50. 5. **Renderizar** e montar a folha de contato.
  51. 6. **Olhar e dar nota** de 0 a 10 em cinco critérios: fidelidade ao pedido, composição, cor e luz, acabamento, legibilidade no tamanho de uso. Cada nota baixa vem com o defeito escrito em termos corrigíveis.
  52. 7. **Refazer** atacando os defeitos, até nota 8 ou três rodadas. A partir da segunda rodada, um subagente crítico que não vê o código avalia as imagens.
  53. 8. **Entregar**, dizendo o que ficou fraco.
  54. | Técnica | Para quê |
  55. |---|---|
  56. | `svg` | Logo, ícone, marca, ilustração vetorial |
  57. | `html-css` | Telas, diagramas, infográficos, cartazes com tipografia |
  58. | `canvas2d` | Ilustração e arte procedural, com ruído, textura e semente fixa |
  59. | `webgl-shader` | Cena realista de objetos por path tracing num fragment shader |
  60. | `edicao` | Editar e restaurar uma imagem existente por operações em pixels |
  61. | `blender-pelo` | Animal peludo realista: modelo 3D com fios de pelo e luz do Cycles (precisa do Blender) |
  62. ## Exemplos
  63. Todos feitos com o próprio plugin, seguindo o fluxo. As notas são a **menor** das cinco da rubrica. A
  64. coluna do crítico é a nota que um subagente independente deu à versão anterior de cada imagem. As
  65. correções que ele apontou foram aplicadas e as imagens abaixo já são as corrigidas.
  66. | Exemplo | Técnica | Rodadas | Nota do crítico (antes da última correção) | Fonte |
  67. |---|---|---:|---:|---|
  68. | Logo "nascente" | `svg` | 3 | 7 | [`exemplos/logo/`](exemplos/logo/) |
  69. | Ícone de bússola | `svg` | 1 | 8 | [`exemplos/icone/`](exemplos/icone/) |
  70. | Infográfico | `html-css` | 3 | 7 | [`exemplos/infografico/`](exemplos/infografico/) |
  71. | Lago ao entardecer | `canvas2d` | 3 | 7 | [`exemplos/ilustracao/`](exemplos/ilustracao/) |
  72. | Natureza-morta | `webgl-shader` | 5 | 6 | [`exemplos/natureza-morta/`](exemplos/natureza-morta/) |
  73. | Foto restaurada | `edicao` | 5 | 5 | [`exemplos/restauracao/`](exemplos/restauracao/) |
  74. | Cachorro em 3D | `blender-pelo` | 4 | não avaliado | [`exemplos/cachorro-3d/`](exemplos/cachorro-3d/) |
  75. ### Animal realista em 3D
  76. ![Cachorro em 3D com pelo](exemplos/cachorro-3d/cachorro-3d.png)
  77. O mesmo pedido ("um cachorro realista") pintado em `canvas2d` deu [esta pintura](exemplos/cachorro-3d/antes-pintura-2d.png).
  78. Em 3D o pelo, o brilho dos olhos e o desfoque são reais, mas o corpo é feito de formas simples e o resultado
  79. lê como pelúcia bem fotografada, não como foto de um cachorro de verdade.
  80. ### Logo e ícone
  81. ![Prancha da marca nascente](exemplos/logo/logo.png)
  82. <img src="exemplos/icone/icone.png" width="320" alt="Ícone de bússola"> <img src="exemplos/icone/reduzido.png" width="420" alt="O mesmo ícone em 128, 64, 32 e 16 px">
  83. ### Ilustração
  84. ![Lago ao entardecer](exemplos/ilustracao/ilustracao.png)
  85. Folha de contato das três variações de paleta da primeira rodada:
  86. ![Folha de contato da ilustração](exemplos/ilustracao/folha-de-contato.png)
  87. ### Cena realista (render)
  88. ![Natureza-morta renderizada](exemplos/natureza-morta/natureza-morta.png)
  89. Path tracing de superfícies descritas por funções de distância, com luz de área, sombra suave, vidro com
  90. água, profundidade de campo, ACES e grão, tudo num shader de uma página HTML. É um render e parece um
  91. render: o copo é simples, a madeira é borrada e a pera tem brilho de plástico.
  92. ### Foto restaurada
  93. ![Antes e depois](exemplos/restauracao/antes-depois.png)
  94. A foto danificada foi fabricada de propósito a partir do render acima (desbotada, amarelada, com ruído,
  95. 16 riscos e 90 pontos de poeira) e restaurada por código. Contra o original, o PSNR foi de 14,7 dB para
  96. 24,7 dB. Riscos, poeira e a dominante amarela saíram. A textura fina não voltou, e a imagem ficou com um
  97. ar de pintura: tirar ruído forte leva o detalhe junto.
  98. ## Estilos
  99. Doze estilos prontos em [`estilos/`](estilos/), cada um com paleta em hex, luz, textura, traço, regras de
  100. composição e um trecho de código: vetor plano moderno, isométrico, aquarela, tinta e papel, retrô anos 60,
  101. cartaz minimalista suíço, neon noturno, render de produto em estúdio, blueprint técnico, pixel art, recorte
  102. de papel em camadas e gravura em linha.
  103. Os seus estilos ficam em `.claude/imagens/estilos/` no seu projeto e **têm prioridade** sobre os do plugin.
  104. Quando gostar de uma imagem, peça "salva esse estilo" ou use `/imagem-estilo salvar <nome>`.
  105. ## Fichas de consistência
  106. Para o mesmo personagem ou a mesma marca reaparecer **igual** em várias imagens, a figura vira uma função
  107. de código com parâmetros (pose, expressão, tamanho) mais uma ficha com paleta, proporções e regras. Como é
  108. código, sai idêntica toda vez. As fichas ficam em `.claude/imagens/fichas/` no seu projeto.
  109. ![Ficha pingo: uma função, o mesmo personagem](exemplos/ficha/pingo-poses.png)
  110. O exemplo completo (ficha, módulo e página de demonstração) está em
  111. [`modelos/ficha-exemplo/`](modelos/ficha-exemplo/). Funciona para figura estilizada com um conjunto fechado
  112. de poses, não para personagem em pose livre vista de qualquer ângulo.
  113. ## Scripts
  114. Node, sem dependências. Todos aceitam `--ajuda`, imprimem uma linha JSON e saem com código diferente de 0 em erro.
  115. ```bash
  116. node scripts/renderizar.mjs pagina.html saida.png --largura 1280 --altura 960 # .html ou .svg para PNG
  117. node scripts/folha-de-contato.mjs folha.png a.png b.png c.png # folha rotulada
  118. node scripts/antes-depois.mjs antes.png depois.png lado-a-lado.png # duas imagens lado a lado
  119. node scripts/info.mjs saida.png --espera 1280x960 # confere o tamanho
  120. ```
  121. O renderizador controla o navegador pelo protocolo DevTools sobre pipe, espera a página avisar que
  122. terminou (`window.IMAGEM_PRONTA = true`), devolve os erros de JavaScript e de shader no JSON e confere
  123. que o PNG saiu com o tamanho pedido. Opções: `--escala`, `--transparente`, `--canvas`, `--seletor`,
  124. `--limite`, `--gpu`.
  125. ## Estrutura
  126. ```
  127. .claude-plugin/ plugin.json e marketplace.json
  128. skills/gerar-imagem SKILL.md (o fluxo) e referencias/ (um guia por técnica, rubrica, composição, estilos, fichas)
  129. agents/ critico-de-imagem.md
  130. commands/ imagem, imagem-editar, imagem-estilo, imagem-ficha
  131. scripts/ renderizar, folha-de-contato, antes-depois, info
  132. modelos/ um ponto de partida funcional por técnica, e a ficha de exemplo
  133. estilos/ a biblioteca de estilos
  134. exemplos/ as imagens desta página, com o código que gerou cada uma
  135. ```
  136. ## Licença
  137. MIT. Veja [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

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