INSTALLATION
怎么安装技能？
三大平台都遵循同一个开放标准：把含 SKILL.md 的技能文件夹放到指定目录，智能体会自动发现并加载。
1
对话安装（最简单）
直接对 WorkBuddy 说 "帮我安装 XX 技能"，在弹出的推荐卡片中一键启用即可，无需任何命令行操作。
2
手动安装（用户级 / 项目级）
把技能文件夹放到以下目录之一，重启会话后自动生效：
# 用户级：所有项目通用
Windows: C:\Users\<用户名>\.workbuddy-ai\skills\<技能名>\SKILL.md
macOS: ~/.workbuddy-ai/skills/<技能名>/SKILL.md
Linux: ~/.workbuddy-ai/skills/<技能名>/SKILL.md
# 项目级：仅当前工作区可用，适合团队共享
<项目目录>/.workbuddy-ai/skills/<技能名>/SKILL.md
3
验证安装
新开会话，直接描述任务（如"帮我做一份 PPT"），智能体会自动匹配并调用对应技能；也可以在技能管理面板中查看已启用技能。
💡 提示：从本站下载技能后，解压出以技能名命名的文件夹（内含 SKILL.md），整体放入上述目录即可。
1
安装 Codex CLI
npm install -g @openai/codex
codex --version
# 首次运行按提示完成 ChatGPT 登录或 API Key 认证
2
把技能放入 skills 目录
Codex 启动时扫描 ~/.codex/skills/ 下所有技能的名称与描述，按需自动加载，不占用多余上下文：
# macOS / Linux
git clone https://github.com/anthropics/skills /tmp/skills
mkdir -p ~/.codex/skills
cp -r /tmp/skills/document-skills/pdf ~/.codex/skills/
# Windows（PowerShell）
# 技能目录为 C:\Users\<用户名>\.codex\skills\<技能名>\SKILL.md
3
新开会话使用
运行 codex 进入新的对话，技能即被识别。直接下达任务，Codex 会在匹配时自动读取技能指令。
⚠️ 旧对话因缓存可能读不到新技能，务必新开一个对话验证。
1
手动安装（两种作用域）
Claude Code 扫描以下两个位置：
# 用户级：全局生效，适合个人常用技能
~/.claude/skills/<技能名>/SKILL.md
# 项目级：仅当前仓库生效，适合团队共享（可提交到 Git）
.claude/skills/<技能名>/SKILL.md
2
插件市场安装（推荐）
# 在 Claude Code 中依次执行：
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
3
验证安装
新开会话后输入任务，Claude Code 会扫描 SKILL.md 的 description 进行匹配并自动加载完整指令。
1
SKILL.md 是什么？
由 Anthropic 发起、被多家智能体采用的开放技能标准：一个文件夹 + 一个 SKILL.md（YAML 头 + Markdown 正文），可选附带脚本与参考资源。智能体启动时只读取名称与描述，任务匹配时才加载全文，极其省上下文。
2
最小可用示例
# 目录结构
my-skill/
├── SKILL.md # 必需：技能入口
├── scripts/ # 可选：辅助脚本
└── references/ # 可选：参考文档
# SKILL.md 内容
---
name: my-skill
description: 一句话说明这个技能做什么、什么时候该用（匹配的关键）
---
# 技能名称
## 工作流程
1. 第一步……
2. 第二步……
## 注意事项
- 依赖安装：pip install -r scripts/requirements.txt
3
写好 description 是关键
智能体靠 description 决定何时调用你的技能。写清"做什么 + 何时用 + 触发词"，命中率会大幅提升。用 skill-creator 技能可以让 AI 帮你生成规范的技术能。
🔗 标准仓库参考：github.com/anthropics/skills · github.com/openai/skills