代理专区 · SKILL.md
每个文件夹都是一个技能
这里的每个文件夹都一式两份:给人的一份——执行脚本、演示稿、道具卡、海报、复盘表;给机器的一份, SKILL.md。代理读 frontmatter 认出哪个文件夹匹配需求,再照着指令把准备工作跑完。
技能到底是什么
SKILL.md 是一个分两半的 markdown 文件。frontmatter 是数据——规范内核
(name、description、version、license、
allowed-tools)外加收进 metadata: 的匹配字段,与
catalog.json 一致,于是「要一个沟通活动、双人、15 分钟、线下」
就是按条件筛,不是满站搜。正文是指令——真实可跑的命令,命名遵循 Agent Skills 惯例。
一个技能的两半
--- name: blind-portrait description: 15 分钟两人背对背画图练习,让单向沟通的失真被看见——含扑克规格道具卡、 8 问复盘,以及配对级前后测评。 version: 1.1.0 license: CC-BY-4.0 allowed-tools: Read, Write, Bash(curl:*), Bash(unzip:*), Bash(npm:*) metadata: # 匹配字段——与 catalog.json 相同 category: communication group_size: 2 duration_minutes: 15 setting: offline depth: assessment-type updated: 2026-10-07 --- # 盲画肖像 ## 把这个活动交给 AI 代理运行 # 可运行的准备——命令照抄就能跑
代理工作流,从头到尾
1 —— 发现
skills.json 一个文件列出全部技能:描述、包地址、sha256—— 代理动手前先筛的那张短清单。catalog.json 再补全文件夹数据: 类目、人数、时长、场景、深度、文件大小、归档状态。匿名,不用密钥。
2 —— 安装
一个文件夹一个 zip。curl 下来,unzip 解压——得到的就是以技能命名的目录:
SKILL.md、全部引用文件、manifest,正是 skills 加载器要的形状。
安装工具就是 curl 本身:没有 SDK,也没有围墙。
3 —— 运行准备
技能里的指令把准备全包了:取回扑克道具卡、搭好在线前后测、备齐复盘问题。 每份文件都自带无头环境的登录降级分支,CI 里跑的代理不会卡在登录界面。 代理跑命令;你走进教室时一切就绪。
三步,就是三条命令
# 1 —— 发现(匿名) $ curl https://workshopskill.com/zh/skills.json # 2 —— 安装(匿名):一条命令,装出加载器认的目录 $ curl -LO https://workshopskill.com/zh/activities/blind-portrait/files/blind-portrait.zip $ unzip blind-portrait.zip $ mv blind-portrait ~/.claude/skills/ # Claude Code 例;完整对照表见下 # 3 —— 运行准备(在线前后测需 FormLM 免费账号) $ npm install -g @formlm/cli $ formlm-cli auth login # 无头环境?保留 curl 步骤,这一行人来登 $ formlm-cli smart generate --input "盲画肖像双人练习前后测:6 道李克特题,覆盖指令清晰度、核对假设、换位理解、修复沟通——活动前后答同一批 6 题,自动计算每人的变化"
技能放到哪:各代理速查
| 代理 | skills 目录(个人级) | 项目级 |
|---|---|---|
| Claude Code | ~/.claude/skills/blind-portrait/ | .claude/skills/blind-portrait/ |
| OpenAI Codex | ~/.codex/skills/blind-portrait/ | ./.codex/skills/blind-portrait/ |
| Qoder | ~/.qoder/skills/blind-portrait/ | .qoder/skills/blind-portrait/ |
| Gemini CLI | 粘贴 SKILL.md,或用 GEMINI.md 导入 | — |
| Cursor | 无 skills 加载器——把 SKILL.md 转成 .cursor/rules/ 规则 | — |
| ChatGPT / Claude.ai | 无 shell——把 zip 传进对话,或只读知识部分做方案 | — |
| 其他任意代理 | 能读文件、能跑 shell 的:贴文件、照做,即可 | — |
每份 SKILL.md 结尾都写好了你自己代理的那两个路径;页面底部的教程逐个代理带全流程—— 安装、首跑、排障。
从文件夹到现代工作坊
文件夹是内容,技能是它的搬运方式。引导师的代理一旦能读懂这个抽屉,下面这些就变了:
-
准备工作会滚雪球。需求——「12 人、90 分钟、没投影」——放到 catalog.json 面前就是道算术题:
六对人、每对一套道具,暖场 + 活动 + 复盘刚好塞满这九十分钟。采购清单来自
props字段,不用凭记忆。 - 材料能重新生成。 guide.md 与 debrief.md 是纯 markdown:代理能按人数缩放、翻译, 或改写成引导师讲义。纸面永远和页面一致。
-
测量是自带的。测评型文件夹带
assessment.json——就是柯氏二级评估 「到底有没有人真的学到东西」用的那套预设。第 3 步把预设变成能跑的在线前后测; 每位参与者的变化量自动算好,配对层面的全貌,就是桌上那沓评审卡加复盘。 笑脸表成了可选项,不再是标配。
诚实的边界
- 这些是开放格式的技能——SKILL.md、frontmatter 加可运行指令,走纯 HTTPS。 任何能读文件、能跑 shell 的代理都能用:不锁定,也不需要专用运行时。
- 离线算前后测的变化量不需要账号——算法就自带在每份测评型文件夹里。需要 FormLM 免费账号的只有第 3 步那张可选的在线表单,表单与报告都存在你自己的工作空间,不在我们这儿。第 1、2 步匿名。
- 人类打印,代理解析:PDF 是印给人看的;markdown 和 JSON 是留给机器读的—— 同一份文件夹,同一份事实。
目前已收录的技能
四十六个技能已全部归档,一个文件夹一个技能,之后随新文件夹陆续补充。目录是唯一的事实来源——不在 catalog.json 里的都还没归档。
已收录技能(46)
blind-portrait — communication · 2 人 · 15 分钟 · 测评型 paper-tower — communication · 8–20 人(3–5 人一队) · 30 分钟 · 测评型 two-truths — icebreakers · 8–20 人 · 15 分钟 · 测评型 blanket-drop — icebreakers · 8–20 人(两队) · 10 分钟 · 测评型 common-ground — icebreakers · 8–20 人(3–5 人一组) · 15 分钟 · 测评型 minefield — trust · 8–20 人(两人一组) · 20 分钟 · 测评型 silent-lineup — leadership · 8–20 人 · 10 分钟 · 测评型 the-orange — conflict · 两队各 2–4 人 · 20 分钟 · 测评型 worst-idea-first — creativity · 8–20 人(3–4 人一组) · 20 分钟 · 测评型 start-stop-continue — reviews · 一个 4–8 人团队 · 30 分钟 · 测评型 post-training-survey — feedback-forms · 任意人数 · 填写 5 分钟 · 测评型 workshop-feedback-form — feedback-forms · 任意人数 · 填写 90 秒 · 测评型 training-evaluation-form — feedback-forms · 任意人数 · 当场 7 分钟 + 第 30 天 3 分钟 · 测评型 advantage-compass — self-assessment · 单人 · 25 分钟 · 测评型 smile-sheet-alternative — feedback-forms · 不限人数 · 10 分钟 · 工具包 training-needs-survey — feedback-forms · 不限人数 · 15 分钟 · 工具包 exit-ticket — feedback-forms · 不限人数 · 3 分钟 · 工具包 the-listening-ladder — communication · 2 人(每对) · 15 分钟 · 测评型 relay-brief — communication · 8–20 人(每列 4–6 人) · 20 分钟 · 测评型 draw-what-i-mean — communication · 2 人(背对背) · 12 分钟 · 工具包 one-minute-meetup — icebreakers · 6–20 人 · 15 分钟 · 工具包 paper-plane-intros — icebreakers · 8–20 人 · 15 分钟 · 工具包 same-boat — conflict · 6–16 人(两方) · 20 分钟 · 工具包 yes-and-ramp — creativity · 4–12 人 · 15 分钟 · 工具包 four-lens-sweep — creativity · 4–10 人 · 20 分钟 · 工具包 assumption-audit — creativity · 3–8 人 · 20 分钟 · 工具包 storyboard-the-journey — creativity · 4–12 人 · 25 分钟 · 工具包 escalation-map — conflict · 4–12 人 · 25 分钟 · 工具包 the-delegation-map — leadership · 4–10 人 · 25 分钟 · 工具包 the-reliability-ledger — trust · 4–10 人 · 25 分钟 · 工具包 the-premortem — reviews · 4–12 人 · 25 分钟 · 工具包 the-values-sort — self-assessment · 1–8 人 · 20 分钟 · 工具包 the-trust-timeline — trust · 4–10 人 · 25 分钟 · 工具包 the-not-anymore-list — reviews · 4–12 人 · 25 分钟 · 工具包 the-leader-checkup — leadership · 3–10 人 · 25 分钟 · 工具包 the-energy-audit — self-assessment · 1–2 人 · 15 分钟 · 工具包 the-third-story — conflict · 4–10 人 · 25 分钟 · 工具包 the-decision-rights-map — leadership · 4–10 人 · 25 分钟 · 工具包 the-turning-point — reviews · 4–12 人 · 25 分钟 · 工具包 the-feedback-digest — self-assessment · 1–2 人 · 20 分钟 · 工具包 the-safety-check — trust · 4–12 人 · 20 分钟 · 工具包 roleswap-argument — conflict · 6–16 人 · 20 分钟 · 工具包 rotate-the-lead — leadership · 8–16 人 · 25 分钟 · 工具包 mad-sad-glad — reviews · 6–20 人 · 20 分钟 · 工具包 skill-radar — self-assessment · 6–16 人 · 20 分钟 · 工具包 step-in-if — trust · 8–20 人 · 15 分钟 · 工具包
打开文件夹:盲画肖像 · 纸塔 · 两真一假 · 毯子落名 · 共同点 · 地雷阵 · 无声排队 · 一个橘子 · 最糟主意 · 开始·停止·继续 · 课后反馈问卷 · 工作坊反馈表 · 培训评估表 · 优势罗盘。
技能教程:按场景走完整条链路
二十八篇中文教程:十六篇逐代理安装执行 + 十二篇场景链路,每篇独立可读、命令可抄 (English tutorials)。中文教程总目录: skill-guides。
- Claude Code——装进 ~/.claude/skills 自动命中,含首跑与排查。
- OpenAI Codex——~/.codex/skills 加 AGENTS.md 带路,终端代理照打执行。
- ChatGPT——无终端用法:上传资料夹做方案、Projects 固化工作流、与执行方接力。
- Gemini CLI——GEMINI.md 的 @ 导入挂上技能,shell 照打执行。
- Cursor——一分钟把包转成 .cursor/rules 按描述触发的规则。
- Windsurf——Cascade 的规则 + 激活模式,最接近原生加载器。
- Cline & Roo Code——.clinerules 常驻短规则 + 真实终端,产出全进仓库。
- Qoder——原生技能目录:~/.qoder/skills 放下即加载。
- Trae——一条项目规则带出整个 skills/ 抽屉。
- Zed——AGENTS.md 指路;要完整加载器可 ACP 挂 Claude Code。
- Amp——线程不记事:盘上一个目录 + 一条常驻指令。
- opencode——开源终端代理读同一套约定,零定制。
- GitHub Copilot——指令文件当加载器,Copilot CLI 照打跑。
- npx skills 注册表——一行流、自建注册表、以及 curl 什么时候更好。
- 无加载器代理——通用粘贴执行法:贴文件、留约束、命令变清单。
- 自建代理——开发者向:skills.json 字段、sha 校验、function-calling 循环。
- 个人评估——优势罗盘技能,代理当考务官,理论引 AssessWiki。
- 理论学习——每个概念对一个可运行文件夹,出处链到 AssessWiki 集群。
- 二创上架——CC BY 机制:换内容、留形状,打包成自己的技能去售卖。
- 二维码与大屏——文件夹 + QRCARD-AI:反馈上墙,每张活码有纸面孪生。
- 评估报告——测评预设.json 经 FormLM 变成逐人变化量报告。
- 30 分钟备课——discover → install → run 全程带秒表。
- 远程与混合——setting 字段替你预判:什么能搜、什么换、什么别搬。
- 复盘到 30 天报告——开始·停止·继续接上测量三段拍。
用代理的人,常问这几个
什么是工作坊技能?
每个活动文件夹里那份 SKILL.md:一半是供匹配的 frontmatter(类目、人数、时长、场景、道具), 一半是给代理跑准备的指令。和文件夹里其他文件一样,CC BY 4.0 免费开放。
哪些 AI 代理能用这些技能?
只要能读 markdown、能跑 shell 命令的代理都行——编程代理、终端助手,或你自己写的脚本。 文件就是 HTTPS 上的纯文本:读取和安装不用 SDK、不用鉴权。
怎么把技能装进我的代理?
一条命令:curl 下载文件夹的 zip 包,unzip 解压。得到的是以技能命名的目录——
SKILL.md、它引用的全部文件、manifest。把这个目录放进代理的 skills 目录:
Claude Code 放 ~/.claude/skills/,OpenAI Codex 放 ~/.codex/skills/,
Qoder 放 ~/.qoder/skills/。页面底部的教程逐个代理带全流程。
什么东西需要账号?
浏览、下载、打印、跑活动、算前后测的变化量都不用账号——每个测评型文件夹都自带一份标准库算法,离线就能算出每位参与者的变化量。需要 FormLM 免费账号的只有在线表单那一步(代理工作流的第 3 步,或活动页的「变成在线版」段落);表单和数据都留在你自己的工作空间。
文件夹教人怎么跑活动,技能教代理怎么准备。 两边读的是同一份 catalog.json——代理查到的,就是你页面上看到的。