Skill Packer

Back

常见问题

01

.skill 文件是什么?

.skill 文件是一个 ZIP 归档,包含技能所需的全部内容:SKILL.md 文件以及它用到的脚本和资源。Skill Packer 把 GitHub 上的技能(skills)打包成这种便携文件。你可以把它拷贝到其他机器、归档保存或传给同事。用 npx skill-packer add my-skill.skill 即可安装,无需联网。由于 .skill 是标准 ZIP,任何解压工具都能直接打开和管理它,方便手动归档。

02

如何在隔离网络(air-gap)的机器上安装技能?

打包需要网络:服务器要从 GitHub 克隆技能仓库来生成 .skill 文件;安装不需要网络。在有网络的机器上下载 .skill 文件,通过 U 盘、内网等任意介质拷贝到离线机器,然后按以下方式安装:

  • 能访问 NPMJS:运行 npx skill-packer install my-skill.skill --global,安装到 ~/.agents/skills;在项目目录内运行则安装到 ./.agents/skills
  • 完成无网络就用任意解压工具.skill 是标准 ZIP,下载页的一键复制命令 unzip my-skill.skill -d ~/.agents/skills/ 在装有 unzip 的机器上都能用;图形界面解压工具也可以。
03

Skill Packer 和 npx skills 有什么区别?

npx skills 直接从在线仓库安装技能,需要联网,且始终拉取最新状态。Skill Packer 产出独立的 .skill 文件,可以随身携带、归档,并在任何地方安装,包括没有网络的机器。它是打包工具,相当于技能界的 .deb.gem 安装包;npx skills 是在线安装器。

04

有什么限制?

Skill Packer 接受单个仓库上限 100 MB。每个打包任务 5 分钟超时,每次最多排队 10 个任务。下载文件与浏览器会话绑定,请在关闭标签页前完成下载。

05

Skill Packer 安全吗?

Skill Packer 在打包前校验每个技能:检查归档内容是否路径穿越,要求包含根级 SKILL.md,并按实际解压字节数执行大小限制(压缩炸弹防护)。Skill Packer 是一个开源软件,其源代码可以在 Github 获取。

06

哪些 AI 工具支持 .skill 文件?

所有遵循 SKILL.md 约定的工具都支持:Claude Code、OpenCode、Cursor,以及其他从 .agents/skills 类目录读取技能的智能体。格式遵循 agentskills.io 的社区标准。