Notion Skills API 怎么把技能同步进 GitHub
Notion 2026-09-17 开放 Skills API：技能页可同步到 GitHub，并用 npx skills add 装进 Vercel skills CLI。适合非研发同事改 skill 的团队。
Notion 在 2026 年 9 月 17 日的官方博客里推出团队技能库，并给出 Skills API：把 Notion 里标成 skill 的页面，导出成符合 Agent Skills 规范的文件。对已经用 GitHub 当 Claude、ChatGPT 或 Grok Bot 技能源的团队，notion skills 同步 github 这条路径是让非研发同事改文档、让 Agent 仍从仓库加载。
库解决的是「谁来改」，不是「模型会不会听」
博客把客户要的库归纳成四条：全团队能用（销售、财务、运营，不只工程师）、不锁死在一个 Agent、能协作改并保留权限和版本、管理员能看用量并控制下发。技能在 Notion 里就是普通页面，可以放进数据库，也可以挂附件和代码目录，以便装下规范要求的整包文件。
这不替代 Skills 和 MCP 的分工。MCP 仍负责连外部系统；Notion 这里管的是技能正文放哪、谁有权改。
同步到 GitHub 之后 Agent 才认原生菜单
许多团队把技能放在 Git 仓库，再接到 Claude、ChatGPT、Grok Bot。工程师改 Markdown 没问题，市场和运营往往没有仓库账号。Skills API 的用法是：Notion 当编辑端，同步进 GitHub 当分发端。同步完成后，博客称这些技能能用上各 Agent 应用自己的 / 菜单和管理员安装开关。
反向也通：可以用 Agent 里的 MCP 工具把现有技能上传回 Notion 再改。博客引用了两家客户的原话，大意都是「写技能的人不都是开发者，所以不能只活在 GitHub」。这是客户引言，不是独立审计。
官方同时开源了一个 starter kit，给 IT 用编码 Agent 把同步搭起来。博客没有把仓库 URL 写进摘要段。仓库地址在 Notion 文档的 Agent Skills API 页，不要凭博客标题猜仓库名。
Vercel skills CLI 的两条命令
Vercel 的 skills CLI 已接这套 API。博客给出的用法是：
npx skills add <notion 里标成 skill 的页面>
npx skills add notion
第一条装单个页面。第二条进入交互，从当前工作区可选的插件里安装。CLI 不解析 Notion 私有格式，因为 API 返回的已是规范文件。skills CLI 开源，可当作自己写集成的样本。
成员可以在本机交互安装，也可以把同一条命令放进脚本。权限仍跟 Notion 页面走：没有页面权限的人，API 不会把技能文件交给他。
什么团队先别上
- 技能只服务一个仓库、改动的人全是提交代码的工程师：直接放 Git 更少一跳同步。
- 技能里夹了生产密钥或客户数据：Notion 页面的分享范围往往比私有仓库更宽，先收紧权限再同步。
- 期待「装上 API 模型就会按技能执行」：API 只负责把文件交到 Agent，执行仍取决于那个 Agent 是否加载、是否被管理员启用。
若你已经在 Cursor 里加载 Claude 技能目录，同步进 GitHub 之后还要确认 Cursor 读的是那份仓库，而不是本机另一份旧拷贝。加载方式见 Cursor 加载 Claude skills。