agent-plugins-spec

统一智能体插件格式，让扩展一次打包到处运行

开源 🏷️完全免费 ✅ 目前可打开智能体 🍴 复刻 79 🐛 待处理 18 👀 关注 33

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1440

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源规范，免费使用，无付费版本。

项目预览

项目数据

分类智能体

开发团队agentplugins

官网地址https://agent-plugins.org

GitHubhttps://github.com/agentplugins/agent-plugins-spec

定价模式🏷️完全免费

价格说明开源规范，免费使用，无付费版本。

访问状态✅ 目前可打开

是否开源是

开源协议NOASSERTION

技术栈/模型agent-plugins,agent-skills,ai-agents,mcp,specification

GitHub 星标★ 1440

上线时间2026-04-03 00:00:00

代码更新2026-11-06

仓库体积228 KB

本站数据更新2026-11-09

维护状态活跃

收录时间2026-08-09

浏览次数4

项目介绍

Agent Plugins Specification 是一份关于如何将 AI 智能体扩展打包成可分发插件的轻量级标准规范，当前版本为 v1.0.0。它解决的是智能体生态中插件格式碎片化、难以复用和分发的问题，为开发者提供了一套统一的打包、描述和交互方式。该规范定义了插件的基本结构、元数据格式以及运行时接口，使得插件可以跨不同的智能体框架进行移植和共享。其核心能力包括：标准化的插件清单文件、清晰的技能声明机制、以及与 MCP（模型上下文协议）的兼容性设计，从而让开发者能够更高效地构建、发布和安装智能体扩展，降低集成成本，促进生态的互操作性。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1440

技术标签

agent-plugins agent-skills ai-agents mcp

使用教程

⚠ 本教程由 AI 依据该项目 README 整理；原始文档不完整，部分步骤为通用流程推断，实际安装请以项目官方文档为准。

难度：入门约 10 分钟部署方式：本地安装 4 步

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

环境要求

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

安装与启动步骤

1创建插件目录

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

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编写 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在客户端加载插件

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

关键配置

配置项	必填	说明	示例
`$schema`	是	插件清单使用的 schema 地址，需与规范版本对应	`https://agent-plugins.org/schemas/1.0.0/plugin.schema.json`
`name`	是	插件在 plugin.json 中的名称	`hello-plugin`
`SKILL.md 的 name`	是	技能名称，写在 SKILL.md 的 frontmatter 中	`greet`
`SKILL.md 的 description`	是	技能描述，写在 SKILL.md 的 frontmatter 中	`Greet the user and offer help.`