GitHub：github.com/xingbofeng/…
我在 Codex 里攒了不少 Skills。
代码 review、CI 排查、前端验收、文档生成、发布检查、推广文案、本地知识库检索……这些东西在 Codex 里很好用，但一换到 Claude Code，就有点尴尬。
最直接的办法是复制文件。能用，但目录多了以后，版本容易乱。自己写 OpenAI Agent SDK 项目时也一样，明明已经有 SKILL.md，最后还是要重新写 tool schema 和 handler。
朋友问我这套工作流怎么搭的，也不好讲。发 prompt 太散，发本地目录又不合适。
所以我做了 SkillDeck。
它不是替代 Codex 或 Claude Code，也不是单纯同步 Skill 文件。同步有用，但同步之后还有问题：Claude 怎么发现这些 Skill？什么时候加载？Skill 多了以后，要不要全塞进上下文？
SkillDeck 做的是中间这一层：扫描本地 SKILL.md，整理成 Skill inventory，再通过 MCP 暴露给 Claude Code、Cursor 这类工具。
三种模式大概是这样：
| 模式 | 给 agent 看到什么 | 适合什么情况 |
|---|---|---|
compact | 搜索、读取接口 | Skill 很多，工具列表要短 |
guided | compact + skill_guide | 让 agent 先看有哪些能力 |
active | guided + use_skill_* | 常用 Skill 直接出现在工具列表 |
我一般先用默认的 active。Skill 少的时候无所谓，Skill 多了以后，先看索引、再按需加载，比一股脑塞上下文舒服很多。
Claude Code 里可以这样装：
claude mcp add skill-deck \
-- npx -y skill-deck mcp serve \
--skills ~/.codex/skills
装完以后，在 Claude Code 里输入：
/mcp
确认 skill-deck connected。
然后就可以直接说：
请用 SkillDeck MCP 搜索适合做代码 review 的 Skill，并先读取完整说明。
如果想生成分享页和图文素材：
请使用 SkillDeck MCP，把 ~/.codex/skills 生成一套可以分享给朋友看的 Skill Pack，注意脱敏。
SDK 那块也顺手做了。
如果我自己写 agent，一个已经写好的 SKILL.md 最好能直接变成工具，而不是让我再写一套 schema。SkillDeck 会解析 Skill，做校验，生成稳定 id，再转成 tools 和 handlers。
大概就是：
SKILL.md -> 扫描校验 -> stable id -> tools / handlers -> MCP 或 SDK
分享也是我很想要的功能。
很多 Skill 其实不是 prompt，而是一个人的工作习惯：什么时候该用、先看什么、哪些事不能自动做、最后输出成什么样。
这些东西放在本机很好用，但很难给别人看。SkillDeck 可以生成脱敏后的分享页和图片。不是公开你的本地目录，而是生成一份能读的 Skill Pack。
这是生成出来的分享示例图：
我挺喜欢这个形式。GitHub 能看出一个人做过什么，Skill Pack 更像是在看这个人怎么工作。
