green-screen-cutout-assets

Habilidad de Activos Recortados con Pantalla Verde

Una habilidad de Codex para generar activos de imagen en primer plano sobre fondos de croma y convertirlos en PNG transparentes con un robusto script de recorte local.

Es útil para equipos de aplicaciones/juegos/productos que necesitan pegatinas, mascotas, personajes, accesorios, coleccionables, huevos, decoraciones de interfaz u otros activos en primer plano que deben colocarse de forma natural sobre fondos reales de aplicaciones.

Qué Hace

• Guía los prompts de generación de imágenes para activos en primer plano seguros para recorte.
• Utiliza una imagen fuente de pantalla verde como puente estable cuando la salida PNG verdaderamente transparente no es fiable.
• Estima el color clave real a partir de los bordes de la imagen en lugar de asumir un #00ff00 exacto.
• Elimina solo las regiones de fondo conectadas a los bordes para reducir la erosión accidental del sujeto.
• Aplica difuminado alfa, despill, recorte, informes de control de calidad JSON y hojas de contactos.
• Admite procesamiento de imágenes individuales y por lotes.

Instalación

Desde una copia local:

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

O instala desde GitHub con el instalador de habilidades de Codex después de que este repositorio se publique:

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

Reinicia Codex después de instalar nuevas habilidades.

Uso Rápido

Genera una imagen fuente con un 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

Luego ejecuta:

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

Ejemplo por lotes:

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

Control de Calidad de Salida

Usa el informe/hoja de contactos generado para verificar:

• esquinas transparentes;
• sin franja verde evidente;
• sujeto no erosionado;
• proporciones razonables de transparente/opaco;
• detalles finos como orejas, colas, pelaje, manos o accesorios conservados.

Estructura del Repositorio

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

Notas

Este repositorio contiene solo la habilidad reutilizable de Codex y el asistente de recorte. Las imágenes fuente generadas y los activos específicos de la aplicación deben vivir en tu proyecto, no dentro de la habilidad.