skills-pack

English README

skills-pack 是一个针对 Codex Skills 的组合包提案与 CLI 原型。目标是把“一个个安装 skill”升级为“声明一个 pack，然后一次性分发、安装、校验依赖”。

当前仓库包含两部分：

• 提案文档：定义 skillspack.json|yaml|toml 清单，以及 skill frontmatter 中的 dependencies 扩展
• CLI 原型：提供 init、add-skill、install 三个基础命令

examples/ 目录已经包含三种等价示例：

• examples/skillspack.yaml
• examples/skillspack.json
• examples/skillspack.toml

提案核心

1. Pack 清单

Pack 可以使用以下任一文件名：

• skillspack.json
• skillspack.yaml
• skillspack.yml
• skillspack.toml

示例：

apiVersion: skillspack/v1alpha1
kind: SkillsPack
name: starter-pack
version: 0.1.0
description: Common skills for research workflows
skills:
  - name: deepwiki
    path: ./skills/deepwiki
    version: 1.0.0
  - name: agent-browser
    path: ./skills/agent-browser

2. Skill 依赖

Skill 自身通过 SKILL.md 顶部 YAML frontmatter 声明依赖：

---
name: docs-research
description: Research with DeepWiki and browser automation
version: 1.0.0
dependencies:
  - deepwiki
  - name: agent-browser
    version: ^1.0.0
---

dependencies 是 skill 的真相源。Pack 只负责聚合 skill，不重复维护依赖图。

CLI

安装依赖：

npm install

构建：

npm run build

skillspack init

在当前目录创建一个 pack 模板：

npx skillspack init starter-pack --format yaml

skillspack add-skill

添加一个 skill，并递归分析其依赖：

npx skillspack add-skill ./skills/docs-research

如果依赖 skill 存在于以下候选位置，会被自动加入 pack：

• 依赖 skill 与当前 skill 同级目录
• pack 根目录下的 skills/<dependency-name>
• pack 根目录下的 <dependency-name>

也可以在 frontmatter 里为依赖显式指定相对路径：

dependencies:
  - name: agent-browser
    path: ../shared/agent-browser

skillspack install

将 pack 中的 skills 安装到目标目录：

npx skillspack install --target ./.installed-skills --overwrite

默认会校验 pack 是否包含所有非可选依赖，并按拓扑顺序安装。

当前范围

这个仓库目前是一个可运行原型，先解决三件事：

• 定义 pack 清单格式
• 让 skill 通过 frontmatter 声明依赖
• 提供最小 CLI 闭环

尚未覆盖：

• 远程 registry / 下载源
• lockfile
• semver 解算
• pack 发布协议

详细提案见 docs/proposal.md。