跳到主要内容

创建 Skills

本指南帮助你创建第一个 Skill。

创建步骤​

  1. 创建 Skill 目录

    在 skills 目录中创建新文件夹：

    mkdir -p ~/.MushroomAgent/skills/hello-world

  2. 编写 SKILL.md

    在目录中创建 SKILL.md，包含 YAML frontmatter 和操作指令：

    ---
    name: hello_world
    description: 一个简单的问候 Skill。当用户请求问候时使用。
    ---

    # Hello World Skill

    使用 `echo` 工具打印 "Hello from MushroomAgent skill!"

  3. 加载 Skill

    重启 MushroomAgent 或开始新会话以加载 Skill：

    mushroom-agent skills list

  4. 测试

    发送触发该 Skill 的消息进行测试。

目录结构最佳实践​

skill-name/
├── SKILL.md (必需)
├── scripts/          # 可执行脚本（Python/Bash 等）
├── references/       # 参考文档
└── assets/           # 资源文件

最佳实践​

  • 保持简洁 - 告诉 agent 要做什么，而不是如何扮演 AI
  • 安全优先 - 如果使用 exec，确保提示词不允许来自不受信任输入的任意命令注入
  • 使用目录组织 - 详细的参考文档放在 references/，不要全部塞进 SKILL.md

相关内容​