建议:将 skill 运行时文件收敛到 skills/ 子目录,营销素材移出 skill 树
Author: zhongjisCreated Aug 11, 2026Updated Aug 11, 2026
TL;DR (EN): This repo's SKILL.md lives at the repo root, so tools that vendor the skill (skills.sh / Skills CLI) pull the entire repository — including ~31 MB of marketing images that SKILL.md never references. Proposal: put the runtime skill under skills/nuwa/ and move marketing assets to GitHub Releases (or a folder outside the skill tree), the way huashu-design already does for its README GIFs.
背景
女娲 skill 通过 skills.sh / Skills CLI 被下游 vendored 时,工具会把 SKILL.md 所在目录整棵树 拷进消费者仓库。因为本仓库的 SKILL.md 在仓库根目录,所以整个 repo(含营销素材)都会被拉进每一个使用者的 skill 目录。
数据:被打包但 skill 运行时用不到的营销素材
以下大文件只在 README 里做展示用途,SKILL.md / scripts/ / references/ 从不引用它们:
| 文件 | 体积 | 用途 |
|---|---|---|
cover-distill-minds.png |
6.4 MB | README 封面 |
advisory-board.png |
5.4 MB | README 配图 |
6-agents-parallel.png |
4.9 MB | README 配图 |
assets/hero.gif |
4.6 MB | README hero 动画 |
promo/ (hero mp4/gif、landing pdf/png、deck pdf、cards) |
~10 MB | 宣传物料 |
wechat-qrcode.jpg |
52 KB | 社群二维码 |
| 合计 | ≈ 31 MB | 全部为营销/展示,非 skill 运行时依赖 |
也就是说,任何 vendored 女娲 skill 的用户,仓库里 ~90% 的体积是他们运行 skill 根本用不到的营销图片。
建议
- 把 skill 运行时文件收敛到
skills/nuwa/子目录:SKILL.md+references/+scripts/+examples/+ 功能性assets/。- 这与 Anthropic 官方「一个 skill 一个自包含目录」的约定一致(见 anthropics/skills、Agent Skills 文档)。
- 也与 Skills CLI 的
skills/目录发现约定一致(见 vercel-labs/skills)。
- 营销素材移出 skill 树:把
hero.gif/cover-distill-minds.png/advisory-board.png/6-agents-parallel.png/promo// 二维码 放到 GitHub Releases 或docs/、.github/等 skill 树之外的位置,README 用外链引用。- 这是 GitHub 官方推荐的做法:二进制/大素材走 Releases,保持仓库精简(见 About releases、About large files)。
- 姊妹项目 huashu-design 已经这么做了——它的 README 动画全部走
releases/download/…,仓库里没有营销大文件,可直接参考。
收益
- 下游 vendored 的女娲 skill 体积从 ~34 MB 降到 ~3 MB(只保留
SKILL.md+ examples + references + scripts)。 - README 展示效果不受影响(外链一样能显示)。
- clone / CI / skills 安装更快。
作为一个把女娲 vendored 进自己 agent-skills 仓库的下游用户提的建议,感谢
Source: alchaincyf/nuwa-skill