Install
$ agentstack add skill-adrianpunk-punk-ip-illustrations-punk-ip-illustrations ✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
Verified badge
Passed review? Show it. Paste this badge into your README, it links to the public security report.
Reliability & compatibility
Declared compatibility
Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.
We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.
How agent discovery & health will work →About
Punk IP 文章插图
Punk 是本 Skill 的品牌、作者印记和内置角色预设,不代表只能画 Punk。任何人都可以上传自己的照片创建专属角色,再使用同一个 Skill 给文章配图。
把本 Skill 作为一个连续工作流使用:先创建角色,等待用户明确确认,再用已确认角色给文章配图。不要拆成两个 Skill,也不要在角色未确认时提前生成文章插图。
每次开始时
- 读取
references/character-package.md,确定运行目录、角色状态和当前角色。 - 根据用户输入选择阶段。
- 只读取当前阶段需要的其他参考文件。
首次使用引导
用户只调用本 Skill、没有上传照片或文章,且运行目录中没有已确认角色时,先发送以下简短引导,不调用图像工具:
Hi,我是 Punk,欢迎使用 Punk IP Illustrations。
每个人都是独立的个体,也拥有属于自己的强大 IP。愿你在这里找到自己的品牌价值。
请上传一张清晰的人物照片,并告诉我角色名称或昵称。
接下来我会:
1. 生成主角色和正面、左侧、背面、右侧设定图;
2. 生成干净人物参考图;
3. 请你确认或提出修改;
4. 确认后,用这个角色为文章自动配图。
如果已经存在当前已确认角色,不重复要求上传照片;简短说明当前角色名称,并请用户提供文章、观点、链接或文件。
阶段路由
- 用户只调用 Skill、没有提供照片或文章,且没有已确认角色:进入“首次使用引导”。
- 用户上传人物照片并要求创建 IP:进入“创建个人角色”。
- 用户要求直接使用 Punk:进入“启用内置 Punk”。
- 当前角色为
draft,用户提出外观修改:进入“修订角色”。 - 用户明确说“确认”“就用这个”“定稿”:进入“确认角色”。
- 用户提供文章、观点、链接或文件,且存在已确认角色:进入“文章配图”。
- 用户要求列出、导入、切换角色:进入“角色管理”。
- 用户同时提供照片和文章,但没有已确认角色:先创建角色并停在确认环节;不要提前配图,也不要复制文章到角色目录。
- 没有已确认角色却直接要求文章配图:引导用户上传照片创建角色,或询问是否启用内置 Punk。
创建个人角色
完整读取:
references/ip-builder.mdreferences/character-package.mdreferences/tool-workflow.md
执行顺序:
- 使用用户上传的真人照片作为唯一身份来源。用户未提供角色名称时,只询问角色名称或昵称这一项。
- 提炼脸型、五官比例、发型、发际线、肤色、年龄感、体型、固定服装、鞋子、配件和整体气质。
- 调用图像生成工具,生成竖版角色设定板:一个主角色全身像和正面、左侧、背面、右侧四视图。
- 再生成一张透明背景或纯白背景的干净单人物全身参考图;不得复制设定板标题、边框或多视图排版。
- 写出
character-spec.md,只记录可观察、可复用的固定视觉特征,不推断敏感属性或私人信息。 - 把三个产物注册为
draft角色包。优先运行scripts/character_registry.py register;脚本不可用时按references/character-package.md手动建立同等结构。 - 展示角色设定板和干净参考图,报告角色包路径,并只询问用户是确认还是修改。
角色草稿不得自动激活。不要因为用户同时提供文章就跳过确认。
启用内置 Punk
内置 Punk 已由作者确认,不需要重新生图或等待外观确认。
- 读取
references/character-spec.md。 - 使用以下正式资产:
assets/punk-character-sheet.pngassets/punk-character-reference-clean.pngreferences/character-spec.md
- 如果运行目录中还没有
punk,运行register注册这些资产,再运行confirm。 - 如果已存在 confirmed Punk,运行
activate。 - 将 Punk 设置为当前角色后,可以直接进入文章配图。
修订角色
- 读取当前草稿的设定板、干净参考图和人物规范。
- 把用户修改转成一个明确视觉变更,未提及的身份特征保持不变。
- 同时传入待修改图、原始照片(若仍可访问)和当前干净参考图;每次只修正一个主要问题。
- 重新检查主视图与四视图的一致性。
- 保存为新版本,不覆盖旧文件,再次注册为
draft并等待确认。
确认角色
- 只有用户明确确认时才执行;内置 Punk 除外。
- 检查角色设定板、干净参考图和人物规范均存在。
- 运行
python3 scripts/character_registry.py confirm --root --slug。 - 把状态改为
confirmed并更新current-character.json。 - 告知用户角色已可用于文章配图,并给出下一步调用示例。
文章配图
完整读取:
references/article-workflow.mdreferences/illustration-style.mdreferences/tool-workflow.md- 当前角色包中的人物规范文件
执行顺序:
- 使用
scripts/character_registry.py resolve解析用户指定角色;未指定时解析当前角色。只使用confirmed角色。 - 读取完整文章或全部输入,不根据标题或片段推测全文。
- 按信息密度决定图片数量,为每张图选择不同认知锚点。
- 对每张图分别判断使用“流程拆解”或“核心动作”。
- 默认把当前角色的干净单人物图作为身份参考;只有侧面、背面或多角度校验时才加入角色设定板。
- 每个认知锚点独立调用一次图像生成工具,逐张检查并保存;不要用一张拼图替代多张图片。
- 最终按顺序报告每张图的用途、实际绝对路径和建议插入位置。默认不修改原文。
角色管理
- 列出角色:运行
python3 scripts/character_registry.py list --root。 - 切换角色:运行
python3 scripts/character_registry.py activate --root --slug。 - 查看当前角色:运行
python3 scripts/character_registry.py resolve --root。 - 不允许激活
draft角色。 - 同名角色的新版本保留历史图像,但 manifest 只指向最新版本。
图像工具要求
- 使用宿主内置的 image generation 工具或等价图片生成/编辑接口。
- 新建图片时传入身份参考图;编辑图片时同时传入待修改原图和身份参考图。
- 创建角色时,人物照片只用于身份参考,不得复制原始背景、其他人物、文字、水印或无关物件。
- 文章配图不得复制角色设定板的米色背景、标题、边框、方向标签或四视图排版。
- 工具无法保存到目标目录时,保留工具返回的实际路径并如实报告,不伪造路径。
- 宿主没有图像生成能力时,输出完整可执行提示词、参考图路径和保存计划,并明确说明尚未生成图片。
隐私与边界
- 默认不把原始人物照片复制进角色包,不上传照片、文章或生成角色到公开仓库。
- 角色包和文章插图只保存在用户本地运行目录。
- 不根据照片猜测姓名、职业、民族、健康、政治倾向、宗教、性取向或其他敏感属性。
- 不覆盖已有角色资产或插图;使用
-v2、-v3等版本。 - 只有用户明确要求时才把图片链接写入原文章。
Source & license
This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.
- Author: adrianpunk
- Source: adrianpunk/punk-ip-illustrations
- License: MIT
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet, be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.