OpenProgram Docs

技能#

Skill 是给模型按需加载的领域知识：一个目录，里面一份 SKILL.md。这一页讲 skill 的格式、查找路径和管理命令，帮你给 agent 增加"会做某类事"的能力而不用写代码。

工作机制#

  1. 启动时扫描各 skill 目录下的 <slug>/SKILL.md，解析 front matter 里的 name + description。
  2. 所有 skill 的 name 和一行 description 渲染成 system prompt 里的 skills 块（agentic runtime 的 <available_skills> 块还会带上每份 SKILL.md 的绝对路径）。
  3. 模型判断当前任务是否匹配某个 skill 的 description；匹配时用 read 工具读取 SKILL.md 全文。全文不会自动注入。

skill 本身不执行任何东西。SKILL.md 旁边可以放脚本、参考文件、数据，由现有的 bash / execute_code 工具运行。每个已发现的 skill 还会被投射进 slash command 注册表，在聊天里输入 /<name> 即插入其正文。

格式#

---
name: my-skill
description: 一行说明什么时候该用它——模型靠这句话做匹配。
---

正文是自由 markdown：操作步骤、规则清单、示例……

front matter 是 key: value 形式的 YAML 子集；name 和 description 缺一不可，缺了该目录直接被跳过。

查找路径#

system prompt、管理 CLI 和 slash command 投射使用同一套四个来源：remote-cache（~/.openprogram/cache/skills/）、插件贡献（见 Plugins）、user（~/.openprogram/skills/）和 project（<cwd>/skills/）。重名时后面的、更本地的来源覆盖前面的来源。OpenProgram 不随安装包提供默认 skill；产品工作流由 Programs 提供。

管理命令#

openprogram skills list       # 按来源（user / project / plugin / remote-cache）列出已发现的 skill
openprogram skills doctor     # 扫描 skill 目录找问题
openprogram skills search <q>       # 在发现源里搜索（默认 ClawHub）
openprogram skills install <spec>   # 安装：slug（默认 ClawHub）、clawhub:<slug>、github:owner/repo
openprogram skills update --all     # 对比本地 SKILL.md 哈希与上游，重拉过期的（也可以只传一个名字）
openprogram skills remove <slug>    # 删除已安装 skill（限 project / user / remote-cache）

install 支持 --source 指定发现源 URL（clawhub://、GitHub 仓库或 JSON 索引）。

Last updated · 2026-10-10
PreviousHarnessesNextHistory distillation