本页内容
开发参考
开发 Mearl Skill 插件
了解 Skill 的结构和插件命令规范，用 Mearl Skill Creator 创建并验证可复用的流程。
Skill 与插件的结构
指引型 Skill 告诉 Agent 何时、如何调用已有工具。需要提供自己的可执行命令或工具箱界面时，可以为 Skill 添加插件。
- SKILL.md 声明名称和描述，说明适用场景、输入输出和结果验证方式。
- 用 scripts/main.mjs 或 scripts/main.py 作为插件入口。入口提供 register(app)，通过 app.command() 声明命令。
- 注册和查看帮助时保持无副作用。浏览器调用和业务操作放在命令处理函数中，入参和返回值应能用 JSON 表示。
- 需要工具箱界面时，声明 toolbox 并随 Skill 打包资源。工具箱与命令处理函数复用业务逻辑。
用 Mearl Skill Creator 创建 Skill
在已接入 Mearl 的 Agent 中安装 Creator。新建时提供网站、目标操作和预期结果。改造时提供现有 Skill 的路径和希望调整的行为。
- 说清任务。例如，用 mearl-skill-creator 把 https://example.com/reports 的报表导出做成 report-export Skill，输入日期范围，返回 CSV。
- 让 Agent 在目标浏览器中验证流程。能通过已验证的接口完成的步骤可直接调用接口，依赖页面的步骤使用浏览器操作。
- 检查生成的 SKILL.md 和插件代码，确认登录要求、输入输出及成功判定都已写清楚。
npx skills add https://github.com/mearlhq/mearl --skill mearl-skill-creator --global一条 Skill 命令怎样执行
工具箱和 Agent 可以复用同一项业务操作。插件定义输入和结果，任务需要使用当前网页或登录态时，可以调用 Mearl 的浏览器动作。
- CLI / SDK / MCP 或工具箱提交命令名和输入参数。
- 插件服务找到已安装的命令，启动任务。
- 隔离 Worker执行业务逻辑，按需调用浏览器动作。
- 调用方收到列表、导出文件等结果。
注册并验证本地插件
注册生成的 Skill 目录，再查看 CLI 帮助。将示例替换为实际目录和注册名，在目标浏览器验证入参和结果。SDK 的 invokePlugin 与 MCP 的 plugin_invoke 使用同一个注册名。
npx @mearl/setup plugin ./skills/report-export
mearl report-export --help分发完整的 skills/<name> 目录，包含 SKILL.md、脚本和打包后的资源。标准 Skills 工具可以发现该目录。带 Mearl 插件的 Skill 用 setup plugin install 一次完成安装和命令注册。需要一起分发多项 Skills、Providers 和能力包时，可以用 Preset 组合安装。