主题
技能
使用 skills 为你的 agent 提供对特定能力的访问。
Skills 是可复用的能力,它们为你的 agent 提供专门的流程和工作区知识。每个 skill 都存储在 agent 的长期记忆中,位于 memories/skills/<skill-name>。skill 的名称和描述会在 agent 启动时加载。基于这些信息,agent 可以决定是否使用该 skill。只有当 agent 判断它与当前任务相关时,才会加载完整的 skill 文件。所引用的任何额外资源如果变得相关,也可能被 agent 加载。
使用 skills 可以有助于:
- 通过只提供与当前任务相关的上下文来节省 token 用量。
- 防止 agent 在系统提示中携带过多上下文,那会导致幻觉和不正确的响应。
INFO
Fleet skills 构建于 Deep Agents 之上,并遵循 Agent Skills 规范。有关 skill 结构、SKILL.md 格式和编写最佳实践的详情,参阅 Deep Agents skills 文档。
私有与共享 skill
Skills 可以对单个 agent 私有,也可以在某个工作区内共享:
- Private skills:对其所属的 agent 私有,并存储在 agent 的长期记忆中。
- Shared skills:与工作区共享,并在 Skills 页面上列出。
- 对工作区中的所有 agent 可见。
- 只有创建该 skill 的用户可以编辑或删除它。
- 可以被添加到工作区中的任何 agent,并随 skill 更新而保持同步。
- 被通用聊天自动访问。
编写有效的 skill 描述
将描述写作为何时使用该 skill 的指令,而不是写作为它做什么的标签。agent 仅根据描述来路由任务。它只有在决定使用之后才读取完整的 skill 文件。
例如,不要写 "Helps with email,",而要写:"Use when drafting, replying to, or summarizing emails. Covers tone adjustments, follow-up scheduling, and inbox triage."。
过于宽泛的描述意味着即使该 skill 能正确处理任务,agent 也可能不使用它。与另一个 skill 重叠的描述意味着 agent 可能路由到错误的那个或无法选择。随着你的 skill 库增长,请审查描述是否有重叠,并收窄任何含糊的描述。
创建一个 skill
你可以以两种方式创建 skill:
- With AI:使用自然语言描述该 skill,agent 会为你创建它。你也可以添加额外的资源。任何额外的文件都必须在
SKILL.md中被引用,agent 才能感知到它们。 - Manually:使用一个
SKILL.md文件创建 skill。
NOTE
默认情况下,skills 对其所属的 agent 私有,并存储在 agent 的长期记忆中。你可以与工作区共享一个 skill。
在 Fleet中,选择一个 agent 并提示它创建一个 skill:
Create a skill that helps the agent use the web to research a topic. Use when asked to research a topic, person, company, technology, event, or any question that requires gathering and synthesizing information from the web. Covers news lookups, competitive analysis, background research, and fact-finding tasks. Prefer tavily_web_search for most queries.
你也可以随时将之前的对话转化为一个可复用的 skill。在完成一项任务后,请 agent 捕获该流程:
Turn what we just did into a skill so you can repeat it in the future.
TIP
当你创建一个新 agent 时,如果 agent 会从中受益,Fleet 会自动生成相关的 skills。这些 skill 默认是私有的。你可以从 agent 侧边栏将它们共享到你的工作区。
修复反复出现的错误
对 agent 错误的默认反应是当场纠正它。skill 改变了这一点:它为 agent 提供了在每次遇到那类任务时都要遵循的明确规则,因此同样的错误不会再发生。
当 agent 处理某项任务不正确时,纠正它,然后请它捕获这个修复:
将这个纠正转化为一个 skill,以便你始终以这种方式处理它。
agent 会创建一个编码了正确行为的 SKILL.md。在后续的会话中,它在处理该任务之前会先读取该 skill,而不是从头推理。
编辑一个私有 skill
- 在 Fleet中选择一个 agent。
- 在侧边栏中,展开 Knowledge 抽屉。
- 在 Skills 部分,选择要编辑的 skill。
- 更新 skill 的名称、描述或指令。
编辑一个共享 skill
NOTE
只有创建共享 skill 的用户才能编辑它。
- 导航到 Fleet > Skills。
- 选择要编辑的 skill。
- 更新 skill 的名称、描述或指令。
- 点击 Save Changes。
共享一个 skill
- 在 Fleet中选择一个 agent。
- 在侧边栏中,展开 Knowledge 抽屉。
- 在 Skills 部分,选择要共享的 skill。
- 点击
Share。
一旦共享,该 skill 就会出现在 Skills 页面上。你可以从 agent 侧边栏将共享的 skills 添加到工作区中的任何 agent,而通用聊天会自动识别它们。
NOTE
只有共享 skill 的创建者才能编辑或删除它。
删除一个私有 skill
删除一个私有 skill 会将其永久移除,因为它存储在该 agent 的记忆中。
- 在 Fleet中选择该 agent。
- 在侧边栏中,展开 Knowledge 抽屉。
- 在 Skills 部分,点击
图标(对应要删除的 skill)。
删除一个共享 skill
只有创建共享 skill 的用户才能删除它。
WARNING
删除一个 skill 会将其从工作区以及所有使用它的 agent 中移除。此操作无法撤销。
- 导航到 Fleet > Skills。
- 选择要删除的 skill。
- 点击
Delete skill 图标。
在本地开发中使用 Fleet skills
使用 LangSmith CLI 从你的 Fleet 工作区下载 skills,并将它们安装到本地,供 Claude Code、Cursor 或 Codex 等编码 agent 使用。
默认情况下,文件会保存到 ~/.agents/skills/[skill-name]/,并软链接到 ~/.claude/skills/[skill-name]/。
bash
langsmith fleet skills pull [skill-name] [flags]| 标志 | 描述 |
|---|---|
--global=false | 安装到项目级目录(.agents/ 和 .claude/)而非主目录。 |
--agent | 定位一个特定的 agent(claude、cursor、codex)。 |
--copy | 复制文件而非软链接。 |
--format pretty | 显示所安装 skill 的文件树。 |
例如:
bash
$ langsmith fleet skills pull web-research --format pretty
Installed skill "web-research" to ~/.agents/skills/web-research
Linked: ~/.claude/skills/web-research
web-research/
├── SKILL.md
└── references/
└── search-tips.md