83.3K+Baixar
Ir para o guia de uso
imagegenpor OpenAI

ImageGen Skill.

Um skill de Claude Code e Codex para trabalho com imagens: gera ou edita imagens raster: ilustrações, fotos, texturas, sprites, mockups.

  • Imagens e Arte Generativa
  • Image
Baixar OpenDesignVer guia de uso
openai/skills · skills/.system/imagegen/SKILL.mdSKILL.md
--- name: imagegen description: Generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos, illustrations, textures, sprites, mockups, or transparent-background cutouts. Use when Codex should create a brand-new image, transform an existing image, or derive visual variants from references, and the output should be a bitmap asset rather than repo-native code or vector. Do not use when the task is better … --- ## Top-level modes and rules ## When to use ## When not to use ## Decision tree ## Workflow ## Prompt augmentation
Metadados iniciais e títulos de seção lidos do arquivo original em 14/09/2026 · 16.170 caracteres no total

01 O que faz

O que a Skill imagegen Faz no Claude Code e no Codex

Resumo, fluxo de trabalho e resultados, todos lidos do SKILL.md do skill.

Do SKILL.mdLido em 14/09/2026 · não é uma execução registrada

Nos termos do próprio skill

O imagegen dá ao Codex um workflow de imagens raster: gerar ou editar assets bitmap como fotos, ilustrações, texturas, sprites, mockups e recortes com fundo transparente, e então levar o arquivo finalizado para o projeto. Ele define dois modos de nível superior: a ferramenta integrada preferencial image_gen, que não precisa de chave de API, e um fallback via CLI apenas explícito através de scripts/image_gen.py, que exige OPENAI_API_KEY.

O arquivo separa a intenção (gerar versus editar) da execução (um asset ou muitos), coleta prompts, texto literal, restrições e imagens de entrada rotuladas por papel, e as remodela em um esquema rotulado. Ele termina com validação em relação a assunto, estilo, composição e precisão do texto, iteração de mudança única e salvamentos não destrutivos.

O que ele produz

  • Uma imagem bitmap produzida via image_gen em vez de um placeholder SVG, HTML/CSS ou canvas, sempre que o usuário pedir um asset em estilo raster.
  • A imagem final selecionada movida ou copiada para o workspace, com qualquer código ou referência consumidora atualizada para apontar para ela.
  • Um relatório final informando o caminho final salvo de qualquer asset vinculado ao workspace, o prompt final e qual modo o produziu.
  • Apenas no fallback explícito via CLI, artefatos finais gravados em output/imagegen/.
Veja o exemplo de prompt ↗

Como funciona

  1. 01
    Escolha o Modo de Nível Superior Primeiro

    A geração e edição normais passam pela ferramenta integrada image_gen; a CLI incluída é um fallback que o usuário precisa solicitar pelo nome.

  2. 02
    Classifique a Solicitação como Geração ou Edição

    Modificar uma imagem existente mantendo partes dela é uma edição; fornecer imagens puramente como referências de estilo, composição ou clima ainda é uma geração.

  3. 03
    Decida Onde o Resultado Fica

    Trabalhos de preview ou brainstorming podem permanecer inline no local padrão, enquanto tudo o que o projeto consumir precisa acabar no workspace.

  4. 04
    Coletar as Entradas Antes de Gerar

    Reúna o prompt, qualquer texto exato dentro da imagem, as restrições ou a lista de itens a evitar, e todas as imagens de entrada desde o início, em vez de preencher lacunas depois.

  5. 05
    Reformular o Prompt em uma Especificação

    Os prompts são normalizados em uma especificação estruturada e orientada à produção, em vez de serem expandidos com detalhes criativos não solicitados.

  6. 06
    Emitir Uma Chamada por Asset

    No caminho integrado, lotes e variantes vêm de chamadas repetidas de image_gen, uma por asset ou variante solicitada, e não de uma única flag de lote.

02 Encontre o ideal para você

Quando Usar a Skill imagegen

Use a skill imagegen no Claude Code ou Codex quando o trabalho for de imagem deste tipo. Adequação e limites abaixo são retirados do próprio arquivo da skill.

Boa Combinação

  • Produzir um bitmap totalmente novo, como concept art, uma foto de produto, uma capa ou uma imagem hero de website.
  • Gerar uma nova imagem em que as imagens fornecidas servem apenas como referência de estilo, composição ou clima.
  • Editar uma imagem existente para tarefas como mudanças de iluminação ou clima, substituição de fundo, remoção de objetos, composição, ou recortes com fundo transparente.
  • Produzir muitos assets ou variantes para uma única tarefa, em vez de uma única imagem.

Conheça os Limites

  • Estender ou combinar com um conjunto de ícones SVG/vetoriais, sistema de logotipo, ou biblioteca de ilustrações que já existe no repositório.
  • Formas simples, diagramas, wireframes ou ícones que são mais eficientes de construir diretamente em SVG, HTML/CSS ou canvas.
  • Pequenas edições de assets locais do projeto, quando o arquivo de origem já existe em um formato nativo editável.
  • Qualquer tarefa em que o usuário claramente deseja uma saída determinística e nativa em código, em vez de um bitmap gerado.

O Que Fornecer

  • O pedido principalO prompt principal do usuário fornece o assunto e o objetivo, e é incorporado à especificação como a linha de pedido principal.
  • Imagens de entrada com funções explícitasToda imagem fornecida é identificada como imagem de referência, alvo de edição ou entrada de suporte para inserção/estilo/composição antes da geração.
  • Texto exato e sua tipografiaQuaisquer palavras que devam aparecer dentro da imagem são citadas literalmente, com a fonte e o posicionamento especificados junto a elas.
  • Invariantes e a lista de itens a evitarPara edições, as coisas que não devem mudar são explicitadas, como alterar apenas X mantendo Y inalterado.
  • Uso pretendido do assetInformar se a imagem é um anúncio, um mock de UI ou um infográfico define o modo e o nível de refinamento que o prompt busca.

03 Dentro da skill

Regras que a Skill imagegen Dá ao Claude Code e ao Codex

8 instruções concretas, padrões e limites que o SKILL.md define para o agente — a parte do arquivo que muda o resultado.

  1. A Ferramenta Integrada É o Padrão

    Toda solicitação comum de geração ou edição passa pela ferramenta integrada image_gen, que não requer OPENAI_API_KEY.

  2. Nunca Fazer o Downgrade por Conta Própria

    O agente não deve se mover por conta própria para o caminho de CLI; essa mudança é sempre uma decisão do usuário.

  3. CLI apenas quando solicitado

    Se o usuário optar pelo modo CLI, use o workflow empacotado scripts/image_gen.py e não escreva executores de SDK pontuais.

  4. O script empacotado é somente leitura

    scripts/image_gen.py nunca é modificado; se algo estiver faltando nele, pergunte ao usuário antes de fazer qualquer outra coisa.

  5. Os assets do projeto não podem permanecer em $CODEX_HOME

    Um arquivo referenciado pelo projeto deve ser movido ou copiado para fora do local padrão de imagens geradas antes de a tarefa ser concluída.

  6. Versione em vez de sobrescrever

    Assets existentes só são substituídos quando o usuário solicitar explicitamente a substituição; caso contrário, o novo arquivo recebe um nome de versão paralelo, como hero-v2.png.

  7. Preserve invariantes nas edições

    O trabalho de edição bloqueia o que não deve mudar e salva de forma não destrutiva, em vez de reescrever o asset de origem.

  8. Nenhum tratamento de chave no caminho embutido

    O agente nunca solicita OPENAI_API_KEY ao usar o image_gen, e nunca pede ao usuário que cole uma chave completa no chat.

04 Coloque em prática

Instalar imagegen no Claude Code ou Codex

Um comando npx skills add, depois uma primeira tarefa no seu agente e uma checklist para o resultado.

Adicionar imagegen ao Claude Code, Codex ou Seu Agente

Rode no seu projeto; o instalador pergunta a qual agente adicioná-lo.

Terminal
npx skills add https://github.com/openai/skills --skill imagegen

Forma genérica de CLI skills para skills/.system/imagegen/SKILL.md; o repositório pode documentar seu próprio caminho.

Dê ao Skill uma Primeira Tarefa de Trabalho com Imagem

Adapte este prompt com seu próprio conteúdo e restrições, depois execute no Claude Code ou Codex.

Example prompt
Use case: product-mockup Asset type: landing page hero Primary request: a minimal hero image of a ceramic coffee mug Style/medium: clean product photography Composition/framing: wide composition with usable negative space for page copy if needed Lighting/mood: soft studio lighting Constraints: no logos, no text, no watermark

Fonte: exemplo do SKILL.md (na íntegra).

Verifique o Primeiro Resultado

O que o próprio SKILL.md diz sobre como é um resultado correto:

  • Inspecione a saída em relação ao assunto, estilo, composição, precisão de texto e às invariantes, e evite itens acordados previamente.
  • Faça um único ajuste direcionado e verifique novamente, em vez de agrupar várias mudanças em uma iteração.
  • Para edições, reafirme as invariantes em cada iteração para que a imagem não se desvie do que precisava permanecer inalterado.

No OpenDesign o imagegen já vem empacotado: Plugins → Skills, selecione-o na barra superior.

Baixar OpenDesignLer o quickstart

05 Código aberto, rastreável

Fonte, Licença e Verificação

De onde vêm os fatos desta página e quando foram verificados pela última vez.

Author
OpenAI
Repository
github.com/openai/skills Branch main
Arquivo da skill
skills/.system/imagegen/SKILL.md Checksum de conteúdo registrado na verificação; commit 49f948f
License
Apache-2.0 De skills/.system/imagegen/LICENSE.txt. A skill é open source; a geração de imagens ainda depende de um serviço hospedado.
Estrelas do repositório
27.129 Snapshot do GitHub tirado em 14/09/2026 para todo o repositório openai/skills. Não é uma classificação ou contagem de uso para imagegen.
Verificado pelo OpenDesign
2026-09-14 Arquivo fonte, caminho, texto de licença e contagem de estrelas foram verificados. Incluído no OpenDesign main (verificado em 2026-08-28); uma execução real não foi registrada nesta página.

Dentro do SKILL.md

  1. Modos e regras de nível superiorO image_gen embutido é o padrão; o fallback para CLI é apenas explícito, com precedência de caminho de salvamento e limites de sobrescrita.
  2. Quando usarNovas imagens, geração guiada por referência, edições de imagens existentes e múltiplos assets ou variações.
  3. Quando não usarSistemas vetoriais nativos do repositório, formas nativas de código, arquivos nativos editáveis e saída determinística nativa de código.
  4. Árvore de decisãoSepara a intenção (gerar versus editar) da estratégia de execução (um asset versus vários).
  5. WorkflowDezessete etapas ordenadas, da escolha do modo à construção do prompt, geração, validação e relatório.
  6. Aumento de promptEstrutura os prompts em uma especificação de produção, com aumentos permitidos e proibidos vinculados à especificidade.
  7. Taxonomia de casos de uso (slugs exatos)Slugs fixos de geração e edição para manter a consistência entre prompts e referências.
  8. Esquema de prompt compartilhadoCampos de estrutura rotulados, como tipo de asset, cena, sujeito, iluminação, texto literal e lista de itens a evitar.
  9. ExemplosUma especificação de geração de imagem hero e uma especificação de edição de substituição de fundo que nomeia seus invariantes.
  10. Boas práticas de promptingOrdenação, citação de texto exato, indexação de múltiplas imagens e iteração com follow-ups de mudança única.
  11. Orientação por tipo de assetAponta os templates de tipo de asset para trabalhos de website, jogo, wireframe e logo para sample-prompts.md.
  12. Somente modo CLI de fallbackConvenções de temp e output do CLI, dependências uv e etapas de configuração do OPENAI_API_KEY.
A Descrição da Própria Skill
Gere ou edite imagens raster quando a tarefa se beneficiar de visuais bitmap criados por IA, como fotos, ilustrações, texturas, sprites, mockups ou recortes com fundo transparente. Use quando o Codex precisar criar uma imagem totalmente nova, transformar uma imagem existente ou derivar variantes visuais a partir de referências, e a saída deve ser um asset bitmap em vez de código nativo do repositório ou vetor. Não use quando a tarefa for melhor tratada editando assets SVG/vetor/código nativos existentes, expandindo um sistema de ícones ou logos estabelecido, ou construindo o visual diretamente em HTML/CSS/canvas.

Descrição front-matter do SKILL.md. O arquivo completo tem cerca de 16.170 caracteres. Leia o arquivo completo no GitHub.

ImageGen

Execute imagegen em uma tarefa de trabalho com imagem real.

A skill imagegen vem incluída no OpenDesign. Baixe o aplicativo, selecione a skill em Plugins → Skills, cole o prompt acima e leia o plano antes do resultado.

Baixar OpenDesignVer todas as skills
Terminal
npx skills add https://github.com/openai/skills --skill imagegen