CommunityImagemgithub.com

Nodeclaw-Image-Gen

Use quando um usuário solicitar geração de imagens, edição de imagens, arte baseada em referência, estilos de imagem ou técnicas de imagem em várias etapas por meio do NodeClaw ou de uma API de Imagens personalizada, incluindo refinamento de Pixel Art em mosaico.

O que é Nodeclaw-Image-Gen?

Este skill permite que agentes de IA (como Claude Code, Codex e outros) gerem e editem imagens usando uma interface de linha de comando (CLI) Node.js, sem depender de serviços LLM externos, daemons ou uploads de armazenamento. A comunicação é feita exclusivamente através do NodeClaw ou de uma API de Imagens configurada, com suporte para modelos como 'gpt-image-2' e modos de operação como Gemini nativo. O skill gerencia de forma determinística a preparação local das requisições, validação de configuração e processamento de resultados, salvando as imagens localmente. Inclui ferramentas para seleção de estilos (58 predefinições incluindo importações) e técnicas especializadas, como refinamento de Pixel Art e preservação de composição, que utilizam ferramentas JavaScript nativas para operações como corte, redimensionamento e aplicação de máscaras, eliminando a necessidade de Python ou ImageMagick. A segurança é priorizada: chaves de API nunca são coletadas no chat ou em argumentos de ferramentas, e o uso de imagens de referência exige aprovação explícita do usuário. O fluxo de trabalho típico envolve análise do prompt, seleção de estilo/técnica, execução de teste (dry-run) para revisão de custos e termina com a chamada paga mediante confirmação do usuário.

Funciona com✓Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/DarKWinGTM/Nodeclaw-Image-Gen/tree/HEAD/skills/nodeclaw-image-gen

Installed? Explore more Imagem skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Nodeclaw-Image-Gen faz?

Use o modelo de texto existente para entender o briefing, selecionar estilos/técnicas e chamar a CLI Node fornecida. Preparação, validação e processamento de imagem determinísticos pertencem às ferramentas, não a scripts escritos pelo modelo. Nenhum serviço LLM extra, daemon ou uploader de armazenamento. Salve os resultados reais da API localmente; não os hospede novamente no Telegram/armazenamento/CDNs.

Início

Resolva <skill-root> como o diretório absoluto que contém este SKILL.md carregado; nunca adivinhe a partir do diretório de trabalho. Invoque node "<skill-root>/scripts/image-gen.mjs" ... a partir do espaço de trabalho do usuário para que as saídas relativas sejam geradas lá.

  1. Verifique Node.js 22+ e o CLI --help, depois setup --status --json para verificar a prontidão das credenciais locais sem chamadas de API. Não imprima arquivos de configuração, reescreva configurações a cada uso ou peça ao usuário para repetir escolhas de endereço/modelo salvas.
  2. Padrões: NodeClaw, gpt-image-2, Tarefa-primeiro, uma imagem, ./generated-images/. Para uma instalação de plugin, use /plugin configure nodeclaw-image-gen@nodeclaw-image-gen; alterações pendentes são carregadas através de /reload-plugins na mesma sessão, não em uma reinicialização de rotina. Não afirme que o skill pode abrir ou executar esses comandos nativos. O módulo nativo fornecido passa o endereço/chave como uma ligação efêmera no carregamento/recarregamento; o CLI o valida e ignora exportações antigas de inicialização. Após recarregar, verifique o apiBaseUrl, endpointMode e credentialConfigured efetivos juntamente com setup --status --json. A prontidão de credencial por si só não prova a configuração mais recente ou aceitação da API; status:not_configured pode significar que não há arquivo de configuração independente. Se o endereço permanecer desatualizado ou o aplicativo nativo estiver bloqueado, relate o bloqueio exato de carregamento/configuração sem imprimir valores de ambiente, ler armazenamentos de segredos, reinserir a chave salva, repetir recarregamentos inalterados ou chamar a API. Uma instalação independente selecionada pelo usuário usa node "<skill-root>/scripts/image-gen.mjs" setup --interactive em seu próprio terminal local; ele pergunta pelo endereço base e oculta a chave, com --replace explícito para configuração existente. Nunca colete chaves no chat, AskUserQuestion, especificações, argumentos de ferramentas de comando ou armazenamentos OAuth/token/sessão. Não execute um prompt de chave interativo em uma sessão de ferramenta de IA capturada. Argumentos de chave diretos do instalador/setup existem para automação operada por humanos, não para coleta de segredos pelo modelo.
  3. Reutilize escolhas de modelo/caminho/especificação fornecidas. models --json mescla descoberta ordenada; um modelo manual exato permanece permitido quando não existe catálogo, com capacidade explicitamente não verificada. O endereço/chave de instalação/setup fixa esse endpoint; o modo legado automático ainda tenta o harness ativo exposto antes da fallback configurada/nativa. Não mova uma chave armazenada para outro endereço ou prefixo de proxy.

Gerar ou editar

Gerar cria uma nova imagem; Editar usa imagens/máscaras de origem especificamente aprovadas. Arquivos meramente existentes em um espaço de trabalho não são permissão para enviá-los.

node "<skill-root>/scripts/image-gen.mjs" generate --prompt "Uma cidade ribeirinha tranquila ao amanhecer" --dry-run --json
node "<skill-root>/scripts/image-gen.mjs" generate --prompt "Uma cidade ribeirinha tranquila ao amanhecer" --yes --json

Editar usa edit --prompt TEXTO --image ARQUIVO [--mask ARQUIVO]. Use um --spec ARQUIVO privado aprovado para briefings longos; especificações não são logs de diagnóstico e nunca contêm chaves de API. O CLI anexa rotas de Tarefa/OpenAI ao endereço base salvo. Nativo /v1beta/models/{model}:generateContent requer --api-mode gemini explícito: é somente conteúdo/partes nativas Direct, não implícito por um nome de modelo Google ou chave de compatibilidade Images. A execução existente de google_image_generate_content Images/Task permanece em suas rotas atuais. O transporte nativo Gemini não é prova de faturamento/prontidão de Direct Image. A ajuda do CLI lista as opções reais.

Antes de uma chamada paga, resuma operação/modelo/estilo/especificação/endpoint/método/fallback/saída do dry-run. Use uma forma nativa: Gerar como mostrado / Ajustar / Explorar estilos / Cancelar. Combine apenas perguntas genuinamente faltantes; não pergunte todos os campos. Após aprovação, use --yes; confirme apenas alterações materiais de contagem/endpoint/sequência.

Claude Code usa AskUserQuestion quando disponível; Codex usa request_user_input apenas quando realmente exposto. Não se passe por opções nativas com texto numerado ou mude de modo para inventar uma ferramenta. Automação não interativa selecionada pelo usuário pode usar configuração/especificação fornecidas mais --yes. A integração de importação/forma nativa do Grok Bot não está verificada; um caminho de nuvem não é um arquivo de desktop.

Ferramentas de estilos e técnicas

  • styles list|show ID seleciona aparência; techniques list|show ID seleciona um fluxo de trabalho e suas ferramentas fornecidas. Combine livremente sem uma lista de permissões estilo→técnica ou outro serviço orquestrador.
  • Sugira 2–3 estilos relevantes mais Prompt original / Sem predefinição. Leia uma predefinição selecionada com styles show ID --json; exampleImages[] são URLs de pré-visualização de terceiros opcionais, não entradas de imagem de API aprovadas. Não busque, faça upload ou use-os automaticamente como referências de Editar. As 58 predefinições incluídas incluem 55 estilos importados adicionais; coleções originais em references/style-imports/ são apenas proveniência, nunca outra fonte de estilo ativa. Nomes GIF não implicam suporte a animação. Use apenas o assunto/contexto aprovado para a solicitação atual, não memória privada não relacionada. Pesquise apenas quando solicitado através de uma ferramenta de harness disponível; não envie todo o briefing privado para pesquisa.
  • Leia apenas o fluxo de trabalho selecionado, verifique os requisitos e use suas ferramentas techniques prepare/check/merge fornecidas. Não peça a um modelo mais fraco para implementar lógica de crop/redimensionamento/máscara/cor/merge novamente. Prepare localmente primeiro, depois mostre a contagem e sequência reais de solicitação paga para aprovação. A preparação local nunca autoriza inferência.
  • Refinamento de Pixel Art: prepare tiles vizinhos mais próximos alinhados e especificações de Editar, submeta as edições aprovadas através do cliente existente, verifique e mescle em PNGs de alta resolução/tamanho original. Preservar composição: prepare uma especificação de Editar restrita e verifique o resultado. Ambos fornecem o codec PNG; nenhuma instalação Python/ImageMagick é necessária.
  • Um requisito ausente de helper/mínimo do cliente chama por uma atualização completa do skill aprovada ou parar essa técnica antes de chamadas pagas. Não o substitua por alegações baseadas apenas em contexto, execute código baixado, prometa suavidade ou inicie loops de redesenho pagos.
  • styles|techniques sync pré-visualiza o JSON/Markdown oficial do GitHub; --yes aplica. Namespaces personalizados são separados. Alterações de helper executável requerem uma atualização completa do skill verificada; conteúdo remoto nunca altera auth/endpoints/permissões ou concede aprovação de execução. Predefinições não autorizam divulgação de memória privada.

Resultados e recuperação

Use status e caminhos JSON retornados. saved significa que todos os arquivos esperados foram salvos. pending/outcome_unknown retém o handle e usa resume --handle ARQUIVO, nunca crie outra solicitação. save_failed mantém arquivos bem-sucedidos e tenta novamente o mesmo resultado. Resultados desconhecidos diretos não têm recuperação habilitada. Técnica incomplete/partial sai com código 3; saídas parciais não são totalmente refinadas.

Parar o cliente não cancela uma Tarefa remota. Não mude método/modelo/endpoint para contornar incerteza, autenticação ou política; veja contrato de API. Use visão apenas quando realmente disponível; verificações de arquivo não provam qualidade visual. Nenhum refinamento pago automático.

Para uma solicitação de instalação, obtenha e verifique o pacote GitHub selecionado antes de invocar seu instalador; não presuma que os arquivos de origem já existam localmente. Prefira o fluxo de instalação automática de IA documentado ou o gerenciador de plugins nativo selecionado, nunca uma instalação duplicada. Após a instalação independente, transforme seus commands.configure argv retornados em um comando devidamente entre aspas usando o caminho real instalado para o usuário executar localmente; também retorne os comandos de reconfiguração/status/atualização. Um plugin usa seu formulário de configuração sensível nativo; seu marketplace baseado em Git seleciona a revisão do repositório independentemente dos ativos de lançamento independentes. Terminal humano claude plugin install --config pode fornecer valores de endereço/chave declarados, mas nunca colete uma chave real ou a coloque em um argumento de ferramenta de IA. Não marque a configuração de credencial como concluída até que o usuário a finalize e o setup --status --json local reporte prontidão; isso é prontidão local, não aceitação da API. Se um lançamento independente obrigatório ou versão de marketplace correspondente não estiver disponível, pare com esse bloqueador em vez de inventar recursos instalados.

docs fetch|sync é referência pública opcional, não uma atualização de contrato de tempo de execução. update check|apply independente nunca escreve caches gerenciados por plugin; esses usam o gerenciador de plugins nativo. Instalação/substituição/publicação requerem sua própria autorização, não permissão inferida de uma solicitação de imagem. A interação do usuário segue o idioma do usuário; a orientação base deste skill é inglês.

Habilidades Relacionadas