Skill Package
Skill Package 是供 Agent 安装和使用的文件包：说明输入、调用方法、结果处理，以及实际需要的本地资源。
模板定义云端处理流程；Skill Package 指导 Agent 怎样使用能力，必要时配合本地工具。它与安装后的 Skill 入口有关，但不等于云端模板 JSON。
什么时候需要自己编写
让 Agent 先根据当前平台能力判断：
| 情况 | 创作者怎样处理 |
|---|---|
| 云端模板已能完成任务 | 正常创建、测试和发布，不额外编写本地辅助包 |
| 需要本地文件、浏览器、脚本或外部工具 | 在方案中说明本地能力，完成测试，再上传并校验自己编写的包 |
市场用户仍可安装平台提供的调用包；“无需自己编写辅助包”不等于“用户不能安装 SkillApp”。
包中应说明什么
| 内容 | 要写清什么 |
|---|---|
| 使用入口 | 名称、用途、什么时候使用，以及必要环境 |
| 输入 | 必填资料、允许值、文件格式和一条样例 |
| 调用 | 本地准备与云端步骤，校验、报价和执行确认 |
| 结果 | 输出形式、保存方法和失败后的处理 |
| 辅助资源 | 必需脚本或文件、工具依赖与权限 |
这些是编写内容要点；ZIP 根目录和必要入口文件以上传时的校验结果为准。
每个上架的 SkillApp 都会有一个对应的 ZIP 包，供 Agent 和 API 直接调用。包里只有调用说明，不包含 SkillApp 的内部实现细节。
创建、测试和上传辅助包
- 让 Agent 在模板方案中说明本地与云端分工，确认后创建模板和必要的本地 Skill。
- 检查包的用途、输入、输出、本地工具和权限，按适用费用规则完成测试。
- 确认上传 ZIP，再读取上传结果和私有包校验状态。
检查这个 Skill Package 的输入、云端调用、本地工具、费用确认和结果处理。先展示需要安装或上传哪些内容；等我确认后再处理。
上传通过校验，只代表私有包已保存并校验；不代表已绑定审核，也不代表市场用户已经可以下载。
发布时关联正确的包
需要自定义辅助包时，把确认并通过校验的同一份包与候选模板版本一起提交审核。更换包后重新测试、上传、校验并确认发布范围。
| 状态 | 说明 |
|---|---|
| 私有包校验通过 | ZIP 已上传并通过私有包校验 |
| 已绑定待审包 | 该份 ZIP 已冻结并关联到本次审核 |
| 市场包可下载 | 审核后的公开分发状态允许用户获取 |
待审时显示“市场不可下载”，不一定是上传失败；分别检查私有包、审核关联和公开分发状态。见 提交审核和发布流程。
更新、下载与解除关联
上传替换包前，先读取当前关联并核对要替换的内容。解除关联只移除私有模板当前包的关联，不删除模板、模板版本和历史 ZIP。
下载 ZIP 只保存文件，不会自动解压、安装或执行。更新私有包不会自动替换已经发布的市场包，需要对应的包更新审核。
CLI 查询入口
loomloom skill package private --help
loomloom skill package private upload <template-id> --file <package.zip>
loomloom skill package private show <template-id>
loomloom skill package install market <listing-id> --skill-root <current-agent-skill-root>
上传、替换、解除关联和市场包更新均应先确认实际影响；已有包的并发保护参数以当前帮助为准。
旧 skill install 生成调用包装；skill package install 安装服务提供的 ZIP。skill uninstall 只用于前者，不能当作后者的通用卸载方式。
凭证与内部逻辑
包里不保存共享 API 密钥，也不公开作者未授权的内部配置。付费运行先检查输入、报价并确认；本地安装不授权直接付费执行。
安装使用见 安装与使用SkillApp，开发接口见 API 概览。