Executable Agent Skills runtime

让可执行 Agent Skills 可检查、可运行、可追溯。

SkillRun 把 SKILL.md / SOP、action code、schema、preflight、Manifest 和 run evidence 打包成 Skill Capsule;需要时再通过 MCP Router 暴露给本地客户端。

团队分发 MCP tools 和 Agent Skills 是采用路径;SkillRun 的核心价值是 executable skills 的 runtime / contract / evidence 层。

manifest, package, route
$ skillrun manifest --cwd refund
$ skillrun validate --cwd refund
$ skillrun pack --cwd refund
$ skillrun import <package.skr> --id refund --json
无 Manifest 合同,不执行。.skr 是分发 artifact;运行与 MCP 暴露都由本地 SkillRun Core / Router 管理。

SkillRun model

SkillRun 不是“支持 Skill 和 MCP”的外壳。

Skill Capsule

把 SOP 和 action 绑定

SKILL.md 负责说明能力;action、schema、preflight 和 examples 让这份能力可以被检查、测试和打包。

Manifest contract

运行前先冻结合同

Manifest 保存 source hashes、permissions、adapter、schema 和 MCP exposure。缺失、过期或不匹配就 fail closed。

Run evidence

执行后留下证据

每次运行都有 structured envelope、artifacts、hash、耗时和 run record。stdout / stderr 只是日志,不是业务结果。

Adoption route

团队分发是 SkillRun 的落地路径,不是它的全部定义。

分享 Skill Capsule

团队成员拿到的是可检查的 .skr artifact,而不是需要复制粘贴的提示词或手写 MCP 配置。

本地检查和启用

消费者通过 importcheckdoctorswitchboard 决定是否启用,不盲目执行第三方代码。

按需挂载 Router

Claude Desktop、Codex 或其他 MCP client 挂载 skillrun router serve --mcp,由 Router 暴露已启用能力。

Trust boundary

团队分发不是 marketplace,也不是沙箱承诺。

SkillRun 让能力可检查、可打包、可版本化、可留证;它不会把任意第三方代码自动变安全。签名、provenance 和 publisher identity 是后续高风险设计议题。

当前可用

本地 .skr import、replace、inventory、switchboard、本地/远程 Team Catalog 复核、Router status、mount plan/apply、run evidence,以及 release asset attestations。

Team Library 路线

team catalog 和 Desktop Team Library 用稳定 Core JSON surface 复核共享 catalog URL、生成 install plan,并把 apply 限定在本地 artifact。

明确不做

不做 Public Marketplace,不自动安装依赖,不远程执行未知代码,不承诺 OS sandbox。

下一步

先跑通本地 lifecycle,再用 Desktop Team Library 检查共享 catalog URL,然后决定是否本地安装。