green-screen-cutout-assets

Skill de Recorte de Ativos em Tela Verde

Uma skill do Codex para gerar ativos de imagem em primeiro plano sobre fundos de chroma-key e convertê-los em PNGs transparentes com um script robusto de recorte local.

É útil para equipes de apps, jogos e produtos que precisam de adesivos, bichinhos, personagens, adereços, colecionáveis, ovos, decorações de interface ou outros ativos de primeiro plano que devem ser posicionados naturalmente sobre fundos reais de aplicativos.

O Que Ela Faz

• Orienta prompts de geração de imagem para ativos de primeiro plano seguros para recorte.
• Usa uma imagem-fonte de tela verde como ponte estável quando a saída PNG verdadeiramente transparente não é confiável.
• Estima a cor-chave real a partir das bordas da imagem, em vez de assumir exatamente o #00ff00.
• Remove apenas regiões de fundo conectadas às bordas, reduzindo a erosão acidental do objeto.
• Aplica desfoque de alpha, despill, corte, relatórios QA em JSON e folhas de contato.
• Suporta processamento de imagem única e em lote.

Instalação

A partir de um checkout local:

Copy-Item -Recurse .\green-screen-cutout-assets "$env:USERPROFILE\.codex\skills\green-screen-cutout-assets"

Ou instale pelo GitHub com o instalador de skills do Codex depois que este repositório for publicado:

python C:\Users\19540\.codex\skills\.system\skill-installer\scripts\install-skill-from-github.py `
  --repo ACT-chao/green-screen-cutout-assets-skill `
  --path green-screen-cutout-assets

Reinicie o Codex após instalar novas skills.

Uso Rápido

Gere uma imagem-fonte com um prompt como:

warm hand-drawn journal sticker style, cozy mobile app asset, soft paper texture, pastel warm colors, no hard outline, plain solid chroma green background for cutout, isolated full body centered with generous padding, no shadow touching edges, no text, no watermark

Depois execute:

python .\green-screen-cutout-assets\scripts\chroma_key_cutout.py `
  --input .\source.png `
  --out .\transparent.png `
  --report .\cutout-report.json `
  --contact-sheet .\cutout-contact-sheet.png

Exemplo em lote:

python .\green-screen-cutout-assets\scripts\chroma_key_cutout.py `
  --input-dir public/assets/source-green-screen `
  --out-dir public/assets `
  --report public/assets/cutout-report.json `
  --contact-sheet public/assets/cutout-contact-sheet.png

QA de Saída

Use o relatório/folha de contato gerados para verificar:

• cantos transparentes;
• ausência de franja verde óbvia;
• objeto sem erosão;
• proporções razoáveis de transparência/opacidade;
• detalhes finos como orelhas, caudas, pelos, mãos ou adereços preservados.

Estrutura do Repositório

green-screen-cutout-assets/
  SKILL.md
  agents/openai.yaml
  references/prompt-cookbook.md
  scripts/chroma_key_cutout.py

Observações

Este repositório contém apenas a skill reutilizável do Codex e o auxiliar de recorte. As imagens-fonte geradas e os ativos específicos do aplicativo devem ficar no seu projeto, não dentro da skill.