建议:将 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 根本用不到的营销图片。

建议

  1. 把 skill 运行时文件收敛到 skills/nuwa/ 子目录SKILL.md + references/ + scripts/ + examples/ + 功能性 assets/
  2. 营销素材移出 skill 树:把 hero.gif / cover-distill-minds.png / advisory-board.png / 6-agents-parallel.png / promo/ / 二维码 放到 GitHub Releasesdocs/.github/ 等 skill 树之外的位置,README 用外链引用。
    • 这是 GitHub 官方推荐的做法:二进制/大素材走 Releases,保持仓库精简(见 About releasesAbout 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 仓库的下游用户提的建议,感谢