Transparent visual assets

Skill DwDestiny/codex-visual-asset-skills/skills/transparent-visual-assets

Codex skills for transparent image assets and animation sprite sets

Install

npx -y skills add DwDestiny/codex-visual-asset-skills --skill transparent-visual-assets

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its author says it does

Copied from the file, not written here

Generate transparent-background raster assets with Codex image generation plus deterministic cleanup. Use when the user wants a PNG sticker, icon, mascot, sprite, UI asset, or web-ready visual element with transparent background, or asks to remove/avoid a generated image background while preserving the subject.

SKILL.md

3.7 KB, as published. Nobody here has run it

Transparent Visual Assets

核心判断

先让 Codex 生图得到“容易抠干净”的图，再用脚本做确定性清理。不要要求模型直接画棋盘格透明背景；棋盘格会变成图像内容。优先让模型使用纯色背景，例如 #FF00FF 或 #00FF00，并明确主体不能使用接近背景的颜色。

适合输出：透明 PNG、网页素材、贴纸、图标、单帧 sprite、角色/物体素材。

不适合输出：多帧动画、spritesheet、视频；这些转给 $sprite-animation-assets。

典型使用场景

网站设计素材：Landing page、产品官网、博客插画、功能区装饰、空状态插画。
PPT / 汇报图表：路演页、数据页、业务复盘、图表旁的视觉解释元素。
App / 产品引导：onboarding、权限说明、功能引导、发布说明里的产品插画。
电商 / 社媒贴纸：商品页角标、促销贴纸、社媒封面、公众号配图元素。
游戏 / 互动 UI：小角色、道具、背包图标、按钮素材、单帧 sprite。
视频 / 海报叠加：封面人物、栏目贴片、透明 logo-like 装饰、片头片尾元素。

工作流

明确素材用途、尺寸、主体边界和禁用元素。
调用 Codex 生图能力生成带纯色背景的候选图。
目视检查：主体完整、没有阴影地面、没有漂浮杂点、主体颜色不接近背景色。
用 scripts/prepare_transparent_asset.py 清理纯色背景、裁切透明边缘、输出 PNG。
打开结果或检查报告，确认透明角落、主体不被误删。

生图提示词要点

使用简短、强约束的提示词：

Create a single centered web asset of <subject>.
Use a perfectly flat #FF00FF background for later chroma key removal.
The subject must not contain magenta, pink, or colors close to #FF00FF.
No shadows, floor, scenery, text, labels, checkerboard pattern, glow, blur, or detached decorative particles.
Keep the full subject inside the canvas with clear spacing.

如果主体天然包含粉色或品红，换成 #00FF00、#00FFFF 或其他不会出现在主体里的纯色。

更多提示词和 QA 细节见 references/prompt-and-cleanup.md。

清理脚本

python "${CODEX_HOME:-$HOME/.codex}/skills/transparent-visual-assets/scripts/prepare_transparent_asset.py" \
  --input /absolute/path/source.png \
  --output /absolute/path/asset.png \
  --background "#FF00FF" \
  --threshold 24 \
  --feather-threshold 48 \
  --trim \
  --padding 8 \
  --report /absolute/path/report.json

参数说明：

--background：要移除的纯色背景；不传时用四角颜色估算。
--threshold：颜色容差。背景边缘残留就调大；主体被吃掉就调小或重生图换背景色。
--feather-threshold：可选的边缘柔化容差，用来淡化生图抗锯齿留下的背景色毛边。
--trim 和 --padding：裁掉透明边缘并保留一点安全留白。

脚本只做背景清理，不会补画、重绘、扩图或创造新素材。

验收标准

输出必须是 .png，并带 alpha 透明通道。
四角应透明，主体边缘不缺块。
主体外没有阴影、地面、光晕、漂浮符号、文字或背景色残留。
素材在深色、浅色、棋盘格背景上都能读清。
如果清理后主体明显破损，重新生图或换背景色，不要靠脚本硬修。