# 创建自定义 Skills 🛠
OpenSoul 被设计为易于扩展。"Skills"是为你的助手添加新功能的主要方式。
# 什么是 Skill？
Skill 是一个包含 SKILL.md 文件（为 LLM 提供指令和工具定义）的目录，可选包含一些脚本或资源。
# 分步指南：你的第一个 Skill
# 1. 创建目录
Skills 位于你的工作区中，通常是 ~/.opensoul/workspace/skills/。为你的 Skill 创建一个新文件夹：
bash
mkdir -p ~/.opensoul/workspace/skills/hello-world# 2. 定义 SKILL.md
在该目录中创建一个 SKILL.md 文件。此文件使用 YAML frontmatter 作为元数据，使用 Markdown 作为指令。
markdown
---
name: hello_world
description: A simple skill that says hello.
---
# Hello World Skill
When the user asks for a greeting, use the `echo` tool to say "Hello from your custom skill!".# 3. 添加工具（可选）
你可以在 frontmatter 中定义自定义工具，或指示智能体使用现有的系统工具（如 bash 或 browser）。
# 4. 刷新 OpenSoul
让你的智能体"刷新 skills"或重启 Gateway 网关。OpenSoul 将发现新目录并索引 SKILL.md。
# 最佳实践
- 简洁明了：指示模型做什么，而不是如何成为一个 AI。
- 安全第一：如果你的 Skill 使用
bash，确保提示词不允许来自不受信任用户输入的任意命令注入。 - 本地测试：使用
opensoul agent --message "use my new skill"进行测试。
# 共享 Skills
你也可以在 ClawHub 上浏览和贡献 Skills。