
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 里可以这样装:
bash
claude mcp add skill-deck \
-- npx -y skill-deck mcp serve \
--skills ~/.codex/skills
装完以后,在 Claude Code 里输入:
text
/mcp
确认 skill-deck connected。
然后就可以直接说:
text
请用 SkillDeck MCP 搜索适合做代码 review 的 Skill,并先读取完整说明。
如果想生成分享页和图文素材:
text
请使用 SkillDeck MCP,把 ~/.codex/skills 生成一套可以分享给朋友看的 Skill Pack,注意脱敏。
SDK 那块也顺手做了。
如果我自己写 agent,一个已经写好的 SKILL.md 最好能直接变成工具,而不是让我再写一套 schema。SkillDeck 会解析 Skill,做校验,生成稳定 id,再转成 tools 和 handlers。
大概就是:
text
SKILL.md -> 扫描校验 -> stable id -> tools / handlers -> MCP 或 SDK
分享也是我很想要的功能。
很多 Skill 其实不是 prompt,而是一个人的工作习惯:什么时候该用、先看什么、哪些事不能自动做、最后输出成什么样。
这些东西放在本机很好用,但很难给别人看。SkillDeck 可以生成脱敏后的分享页和图片。不是公开你的本地目录,而是生成一份能读的 Skill Pack。
这是生成出来的分享示例图:


我挺喜欢这个形式。GitHub 能看出一个人做过什么,Skill Pack 更像是在看这个人怎么工作。