前言¶
在 Agent 里挂着一个 Skill，流程跑得很顺，但一旦要交给同事、塞进 CI，或者在没有完整 Agent 的环境里复用，往往会卡在「还得带着整套 Skill 目录和对话上下文」。反过来，手写一个命令行工具，又容易和 SKILL.md 里已经写好的步骤脱节，维护两套东西。
下面介绍 SkillHub 上的 skill-distill（坐标 @user_9d88e4b9/skilldistill）：它面向「已有 Skill、想要可执行脚本」这一路径，由 Agent 读取目标 Skill 的说明与脚本，生成带当前 OpenClaw 模型配置的独立可执行产物。
这是什么¶
skill-distill 是社区来源（community）的 dev-programming 类 Skill，当前版本 1.0.0，发布者为 user_9d88e4b9。
一句话定位：将现有 skill 转换为可执行的脚本工具——读取指定 skill 的 SKILL.md 和脚本，生成独立的可执行脚本，并在脚本中嵌入当前 OpenClaw 模型配置。
官方入口：
- SkillHub 页面：https://www.skillhub.cn/skills/user_9d88e4b9/skilldistill
- API 坐标页：https://api.skillhub.cn/user_9d88e4b9/skilldistill
（SkillHub 页面数据截至抓取时：评分 100000，下载 776；标签含 requires_api_key=true，使用相关能力时需自行准备 API Key。）
核心功能¶
依据官方简介，skill-distill 只做一件事链路上的几步，且都围绕「从 Skill 到脚本」：
- 读取源 Skill：针对你指定的 skill，加载其
SKILL.md以及目录内已有脚本。 - 生成独立可执行脚本：输出不依赖「当场再挂原 Skill 包」的可运行脚本（具体语言与入口以生成结果为准，由源 Skill 内容与 distill 流程决定）。
- 嵌入 OpenClaw 模型配置：把当前环境下的 OpenClaw 模型配置写进生成脚本，便于脚本直连模型、复现 Skill 中的模型调用方式。
官方列出的使用时机：
- 把某个 skill 转换成独立脚本工具；
- 提取 skill 的功能生成命令行工具；
- 将 skill 封装为可直接运行的脚本。
公开资料中未给出单独的子命令手册；实际执行通常是在已安装本 Skill 的 Agent 中，按 SKILL.md 的指引指定目标 skill 并触发蒸馏流程。
安装与启用¶
SkillHub 推荐先具备 skillhub CLI，再把技能装到当前 Agent 能识别的 skills 目录。安装说明以 https://skillhub.cn/install/skillhub.md 为准。
1、检查或安装 skillhub CLI¶
command -v skillhub && skillhub --version
若未安装，可用官方脚本（完整安装含默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装 skill-distill¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/，Agent 可能识别不到。
skillhub install user_9d88e4b9/skilldistill --dir <你的 skills 目录>
SkillHub 页面也给出了等价提示：根据 https://skillhub.cn/install/skillhub.md 安装 @user_9d88e4b9/skilldistill。
常见客户端 skills 路径（来自 SkillHub 安装文档，按你实际环境选用）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
装到对应目录后，按你所用客户端的要求刷新或重启 Agent，使新 Skill 生效。
典型用法¶
公开页面未附带逐步截图或固定 shell 示例；可复现的流程应理解为「在 Agent 内启用 skill-distill，再指向要被蒸馏的 skill」：
- 确认 skill-distill 已出现在当前 Agent 的 skills 列表中。
- 明确源 skill（名称、路径或 SkillHub 坐标），确保其
SKILL.md与脚本在本地可读。 - 在对话中说明目标：例如需要将某 skill 转为可独立运行的脚本或命令行工具；若环境使用 OpenClaw，生成物会带上当时的模型配置。
- 按 Agent 执行蒸馏后的输出，在本地对生成脚本做执行权限与依赖检查（源 Skill 若依赖外部 API，仍受
requires_api_key=true等约束影响）。
经过上面的步骤，你得到的是一份可脱离「原 Skill 包 + 当场挂载」的脚本形态，而不是继续在 Agent 里重复同一套手动步骤。
适用场景与注意¶
适合谁
- 已经把能力沉淀在 Skill（
SKILL.md+ 脚本）里，希望再交付一层「命令行 / 单文件可执行」的开发者； - 使用 OpenClaw 生态，希望蒸馏结果自带当前模型配置、减少手工拷贝配置项的情况。
限制与注意
- 标签
requires_api_key=true：涉及模型或第三方 API 时，需自行管理密钥，不要把密钥写进不可信的共享脚本仓库。 - 蒸馏质量取决于源 Skill 的文档完整度与脚本结构；文档含糊的 Skill，生成脚本也可能需要人工收尾。
- 评分与下载量来自 SkillHub 展示，会随时间变化；以安装前页面为准。
- 本文未核实 Cursor / Codex / Claude Code 在「触发 distill」上的 UI 差异，仅安装路径以 SkillHub 文档为准。
结尾¶
如果你手里已经有一个维护良好的 Skill，却还需要在无 Agent 的场景里跑同一套逻辑，skill-distill 提供的是从 SKILL.md 和脚本出发、落到可执行脚本并带上 OpenClaw 模型配置的一条官方描述路径。安装与坐标以 SkillHub 为准：
https://www.skillhub.cn/skills/user_9d88e4b9/skilldistill
