Skill Packager 是一个技能打包工具，用于将一个或多个 AI 智能体技能（即包含 SKILL.md 文件的目录）转换为可部署到不同平台的格式。其核心用途是简化技能的分发流程，让技能能够以标准化的结构安装到 Claude Code、ChatGPT、Cursor、OpenClaw 等环境中。
主要能力包括：
- 发现并读取技能目录中的 SKILL.md，提取名称、描述、作者、版本、许可证等元数据。
- 根据用户选择的目标平台，生成对应的插件清单和市场配置文件，支持的格式有 universal（全格式仓库）、claude-plugin、claude-marketplace、cursor-plugin、codex-plugin、agent-skills，以及通过 build-zip 子命令生成的通用 ZIP 包。
- 自动构建目录结构、复制技能文件、渲染清单，并生成 .agents/skills/ 副本（用于 Agent Skills 标准）。
- 提供验证脚本，检查 JSON 有效性、版本一致性、路径解析、占位符替换等，确保输出质量。
- 生成 README.md 和 CHANGELOG.md 的模板，需用户手动填充实际内容。
使用方式：该工具以技能形式存在，通常配合 Claude Code 等环境使用。用户需提供技能目录路径，工具会通过交互式提问（如使用 AskUserQuestion 工具）收集缺失的元数据、选择分发范围（全部目标、特定目标或仅 ZIP）和输出目录。随后运行捆绑的 Python 脚本（需在 scripts/ 目录下以 -m 方式执行）完成元数据提取、脚手架生成、ZIP 构建和验证。具体命令示例包括：python3 -m skill_packager metadata、scaffold、build-zip、validate。
适用场景：需要将技能发布到多个 AI 平台、创建可安装的插件仓库、或生成符合 Agent Skills 标准的技能包时使用。也适合为开源项目准备分发结构。
限制与注意事项：
- ChatGPT 技能目前处于测试阶段，仅限特定企业版计划使用，且可能受沙箱限制。
- 部分平台（如 Codex CLI）需要特定安装方式，文档中应说明。
- 工具本身不生成技能内容，仅负责打包；README 和 CHANGELOG 需手动编写。
- 对于依赖外部工具的技能，需在 README 中注明前提条件。
- NanoClaw 对 SKILL.md 有 500 行限制，且仅覆盖操作类和实用类技能。
- 市场名称需手动追加 -marketplace 后缀。
- 需确保路径引用正确，避免相对路径问题。