agent-plugins-spec

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

• 能创建目录和文本文件的本地环境
• 支持 Agent Skills 的客户端（用于加载插件）
• 文本编辑器，可编写 plugin.json 与 Markdown 文件

安装与启动步骤

1. 1创建插件目录

   按 README 的最简结构建立 hello-plugin 目录，并在其下建立 skills/greet 子目录。

   mkdir -p hello-plugin/skills/greet

   复制

2. 2编写 plugin.json

   在插件根目录写入插件清单，$schema 指向 1.0.0 的 schema，name 为插件名。

   cat > hello-plugin/plugin.json <<'EOF'
   {
     "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
     "name": "hello-plugin"
   }
   EOF

   复制

3. 3编写 SKILL.md

   在 skills/greet 下创建技能文件，YAML frontmatter 里写 name 与 description，正文写技能说明。

   cat > hello-plugin/skills/greet/SKILL.md <<'EOF'
   ---
   name: greet
   description: Greet the user and offer help.
   ---
   
   Greet the user and offer help.
   EOF

   复制

4. 4在客户端加载插件

   由支持技能的客户端读取 plugin.json 并发现 skills/greet/SKILL.md；README 未给出具体加载命令。

关键配置

如何确认成功

支持技能的客户端能读取 plugin.json 并发现 skills/greet/SKILL.md，即表示插件结构与加载约定正确。

常见问题

注意事项

• README 为非规范性介绍，正式约束以对应版本的 spec 文件为准。
• $schema 中的版本号应与所用规范版本保持一致（1.0.0 对应 1.0.0 schema）。
• README 未给出安装、端口、路径等运行参数，不要自行添加未定义的清单字段。