WorkBuddy Skill 开发入门:从 SKILL.md 写出一个能跑的技能

发布于 2026-10-29 · 独立第三方评测 · 转载请注明出处

一个 Skill 的本体就是一个文件夹:核心是 SKILL.md 文件(YAML 元信息 + Markdown 正文),可选附带脚本与资源。 Agent 按 description 匹配任务意图,命中后加载该技能执行。SKILL.md 是跨 Agent 的开放标准,Claude Code、OpenClaw 等工具同样兼容——写一次,多处可用。

最小可用示例

建一个文件夹 excel-helper,里面放 SKILL.md:

---
name: excel-helper
description: 处理 Excel 表格任务:合并多个工作簿、清洗数据、
  生成透视汇总。当用户提到处理 Excel/表格/工作簿时使用。
---

# Excel 助手

## 步骤
1. 读取用户指定的表格文件,先输出列名和行数确认理解
2. 按任务要求处理(合并/清洗/透视)
3. 结果另存为新文件,并报告改动摘要

## 注意
- 覆盖原文件前必须先备份
- 日期列统一转为 YYYY-MM-DD

把它放入 WorkBuddy 的技能目录(或通过导入入口加载),新建会话后说”帮我把这三个表合并”,技能就该被触发。

写好 description 是 80% 的工作

Agent 靠 description 决定何时加载你的技能,写法三原则:

1. 写”什么时候用”,不是”这是什么”——用用户会说出口的任务动词:“合并""转换""抓取”
2. 埋触发词:用户任务里出现的词,description 里也要有(Excel、表格、工作簿)
3. 划边界:写清不适用场景,避免误触发

进阶结构:渐进式披露

复杂技能别把所有内容塞进 SKILL.md,标准支持分层加载:

excel-helper/
├── SKILL.md            # 主文件:概要 + 核心流程(保持精简)
├── reference/
│   └── api-details.md  # 详细参考,SKILL.md 里用链接引用
└── scripts/
    └── clean.py        # 可执行脚本,SKILL.md 里说明调用方式

Agent 先读 SKILL.md,需要细节时再按引用深入,省上下文、提命中率。

上线前检查清单

• frontmatter 的 name 与文件夹名一致
• description 含 3 个以上自然触发词
• 破坏性操作(删改/覆盖)有确认或备份机制
• 在新会话里用 3 种不同说法测试触发
• 脚本不要求敏感权限(无关目录、静默联网)

做好了?让更多人用上

• 提交到本站榜单收录,免费曝光给正在找 skill 的用户
• 参考 SEO 技能包案例:精品技能包是可以直接收费的(€25 × 两个月 32 份)
• 标准细节见 agentskills.io(SKILL.md 开放标准)

注:WorkBuddy 客户端的技能目录位置与开发者入口以官方文档为准;本站为独立第三方站点。