pretty-skills
让每个 agent 都能装、每个用户都能改、每个贡献都被看见。
一句话定位
pretty-skills = 跨 agent 的 skill 管理器。
它把你写的每一个 skill 装到 5 大 agent（Claude Code / Codex / Mavis / Cursor / Windsurf）的统一位置，
让你用同一个 ps 命令就能管所有 skill 的增删改、查依赖、提 PR。
快速开始
bash# 一行安装（首次） curl -fsSL https://raw.githubusercontent.com/huangrichao2020/pretty-skills/main/tools/pretty-skills/install.sh | bash # 之后随时用 ps list # 看本地装的所有 skill ps info pretty-skills-creator # 看某个 skill 的详情 ps add serenity-stock-choke # 从主项目装一个 ps graph # 输出 Mermaid 依赖图 ps contribute my-new-skill # 把本地修改推回主项目（提 PR）
设计原则
| 原则 | 怎么落地 |
|---|---|
| 本地优先 | ~/.pretty-skills/store/ 是真实存储，5 agent 都软链到这 |
| 改无门槛 | 直接 vim store 里的文件即可，不需要经过工具 |
| PR 是用户主动判断 | 工具绝不自动 push，需要 ps contribute 才走 |
| 跨 agent 统一 | 一次装，5 个 agent 都能用 |
| 依赖关系透明 | ps graph 一眼看所有 skill 的依赖图 |
| manifest 必填 | 没有 manifest 的 skill 不会被装（防垃圾） |
目录结构
~/.pretty-skills/ ├── store/ # 公共存储（真实文件在这） │ ├── pretty-skills/ │ ├── pretty-skills-creator/ │ └── serenity-stock-choke/ └── config.yaml # 哪些 agent 启用 / 哪些 skill 已禁 ~/.claude/skills/pretty-skills -> ~/.pretty-skills/store/pretty-skills ~/.codex/skills/pretty-skills -> ~/.pretty-skills/store/pretty-skills ~/.mavis/skills/pretty-skills -> ~/.pretty-skills/store/pretty-skills ~/.cursor/skills/pretty-skills -> ~/.pretty-skills/store/pretty-skills ~/.windsurf/skills/pretty-skills -> ~/.pretty-skills/store/pretty-skills
8 个子命令
| 命令 | 作用 |
|---|---|
ps list | 列出本地已装的所有 skill（按 agent 分组） |
ps info <name> | 显示 manifest、依赖、占用空间、最后修改时间 |
ps add <name> | 从主项目装一个 skill（默认源：github.com/huangrichao2020/pretty-skills/tree/main/tools） |
ps rm <name> | 卸载（删 store + 软链） |
ps update <name> | 拉主项目最新覆盖本地（保留本地未 commit 的修改会先备份） |
ps graph | 扫描所有 skill 的 manifest.dependencies，输出 Mermaid 依赖图 |
ps contribute <name> | 把本地修改推回主项目（自动开 fork + 提 PR，附 changelog） |
ps sync | 批量 update（等价于对所有 skill 跑 ps update） |
与 pretty-skills-creator 的关系
- pretty-skills（管）：本文档，管所有 skill
- pretty-skills-creator（创）：创建新 skill 的入口，自动带 4 风格 HTML 占位 + 可选 PPT
- 二者是父子关系：装好 pretty-skills 后，
ps create就把 pretty-skills-creator 调起来
为什么叫"边缘优先开源"？
GitHub 的传统是"主项目维护者写 + 用户提 PR"，pretty-skills 反过来：
- 用户本地增删改无门槛（store 是用户的）
- 用户觉得好的内容 → 主动提 PR 回主项目
- 主项目维护者 review 后 merge
这样每个用户都是潜在贡献者，每个 PR 都是真实使用过的反馈。 主项目不需要全知全能 — 只需要 review + merge 就行。
开发
见 docs/contributing.md（怎么给 pretty-skills 提 PR）
见 docs/skill-schema.md（怎么写一个合法 skill 的 manifest）
