应用市场

创建技能 / 智能体 / 团队仓库

如何组织 GitHub 仓库结构,让 Buda 能够发现并发布你的技能、智能体和团队

Buda 会扫描你的 GitHub 仓库,并根据你放置特定清单文件的位置自动发现技能、智能体和团队。

前往 agentskills.ioagentcompanies.io 浏览社区仓库,获取灵感。

本页面是实现指南

  • 当你想直接构建仓库结构时,使用本页。
  • 当你想把指令粘贴给编程智能体时,使用本页。
  • 如果你想先了解商业概览,请阅读在 Buda 应用市场销售你的技能

面向编程智能体

如果你正在使用编程智能体,可以直接把本页面的 URL 交给它。

本文档以实现规范的方式编写,内容包括:

  • 仓库结构
  • 必需文件
  • 推荐的 README.md / SKILL.md 分工
  • 渲染与可见性规则
  • 私有仓库指引
  • 常见错误
  • 输出检查清单

规则速览

必需

  • 每个技能都必须包含 SKILL.md
  • 每个智能体都必须包含带有效 frontmatter 的 agents/{name}/AGENTS.md
  • 每个团队都必须包含带有效 frontmatter 的 teams/{name}/TEAM.md

推荐

  • 在每个商业技能旁添加 README.md
  • README.md 撰写面向买家的文案
  • SKILL.md 撰写面向智能体的指令
  • 对付费或专有技能优先使用私有 GitHub 仓库

渲染规则

  • 应用市场详情页优先使用 README.md
  • 如果缺少 README.md,应用市场会回退到 SKILL.md / AGENTS.md

可见性规则

  • 买家在购买前看不到完整的技能指令
  • 支持私有仓库
  • 完整实现始终保留在你的仓库中受保护

仓库布局

本仓库遵循 Agent Companies 规范

my-repo/
├── COMPANY.md                     ← optional company root manifest

├── skills/                        ← Skills (any layout works)
│   ├── keyword-research/
│   │   ├── SKILL.md
│   │   └── README.md          ← optional detail/sales page
│   └── content-writer/
│       ├── SKILL.md
│       └── README.md

├── agents/                        ← Agents live here
│   ├── research-assistant/
│   │   ├── AGENTS.md              ← agent manifest + instructions (required)
│   │   └── README.md              ← detail page body (optional, overrides AGENTS.md)
│   └── code-reviewer/
│       └── AGENTS.md

└── teams/                         ← Teams live here
    ├── marketing-team/
    │   ├── TEAM.md                ← team manifest (required)
    │   └── README.md              ← detail page body (optional)
    └── dev-team/
        └── TEAM.md

发现规则:

类型触发文件位置
技能SKILL.md仓库树中的任意位置
智能体AGENTS.md必须位于 agents/{name}/ 之下
团队TEAM.md必须位于 teams/{name}/ 之下

技能 —— SKILL.md

技能是一项可复用的能力,智能体可以安装并调用它。把 SKILL.md 放在仓库中的任意位置。

详情页正文优先使用同一目录下的 README.md(如果存在),否则回退到 SKILL.md 本身。

对于付费或商业技能,我们强烈建议在同一目录中添加 README.md

默认情况下,Buda 在列表项详情页展示 README.md。如果不存在 README.md,则回退到 SKILL.md

推荐模式

让这两个文件各司其职:

  • README.md = 面向买家的页面,用于营销、定位、截图、用例和销售文案
  • SKILL.md = 面向智能体的指令文件,包含真正的运行逻辑
skills/keyword-research/
├── SKILL.md      ← required: frontmatter (name, description) + instructions
└── README.md     ← optional: richer detail page (overrides SKILL.md as body)
---
name: Keyword Research
description: Discover high-intent keywords and cluster them by topic automatically.
---

# Keyword Research

## When to use this skill
Use when the user asks to research keywords or analyze search intent.

可见性与知识产权保护

私有仓库非常适合商业技能:

  • 购买前,终端用户看不到完整的技能指令
  • 列表项详情页只展示你选择呈现的内容,理想情况下通过 README.md 呈现
  • 你的技术诀窍、提示词结构和工作流设计可以保留在私有仓库中受保护

智能体 —— agents/{name}/AGENTS.md

智能体是一个预先配置好的 AI 助手,拥有特定角色和一组声明的技能。AGENTS.md 文件是必需的,其中既包含智能体的元数据(在 frontmatter 中),也包含它的指令(在 markdown 正文中)。

AGENTS.md 格式:

---
schema: agentcompanies/v1
name: Research Assistant
slug: research-assistant
description: A thorough research agent that finds, summarizes, and cites sources.
skills:
  - https://github.com/buda-ai/buda-marketplace#web-search
  - https://github.com/buda-ai/buda-marketplace#summarizer
  - https://github.com/my-org/my-skills#citation-formatter
---

# Research Assistant

You are a research assistant. Find accurate information, summarize clearly, always cite sources.

## Behavior Rules
- Never fabricate sources
- Flag uncertain information

Frontmatter 字段:

字段必需描述
schema必须为 agentcompanies/v1
name在应用市场中显示的名称
slug稳定标识符,与目录名一致
description列表项卡片上的一句话摘要
skillsrepo#skillName 形式列出的技能依赖

可选的 README.md 如果存在,作为详情页正文时优先于 AGENTS.md


团队 —— teams/{name}/TEAM.md

团队是一组在复杂的多步骤工作流中协作的智能体。TEAM.md 文件是必需的,其中既包含团队的元数据(在 frontmatter 中),也包含一段可选的描述正文。

TEAM.md 格式:

---
schema: agentcompanies/v1
name: Marketing Team
slug: marketing-team
description: A coordinated team for content strategy, copywriting, and distribution.
includes:
  - ../agents/strategist/AGENTS.md
  - ../agents/copywriter/AGENTS.md
  - ../agents/analyst/AGENTS.md
---

# Marketing Team

A coordinated team for content strategy, copywriting, and distribution.

Frontmatter 字段:

字段必需描述
schema必须为 agentcompanies/v1
name在应用市场中显示的名称
slug稳定标识符,与目录名一致
description列表项卡片上的一句话摘要
includes指向成员 AGENTS.md 文件的相对路径

可选的 README.md 如果存在,用作团队的详情页正文。


快速开始

mkdir my-repo && cd my-repo
mkdir -p skills/my-skill agents/my-agent teams/my-team

# Create a skill
cat > skills/my-skill/SKILL.md << 'EOF'
---
name: My Skill
description: A brief description of what this skill does.
---

# My Skill

Instructions for the AI agent go here.
EOF

# Create an agent
cat > agents/my-agent/AGENTS.md << 'EOF'
---
schema: agentcompanies/v1
name: My Agent
slug: my-agent
description: A brief description of what this agent does.
skills:
  - https://github.com/my-org/my-repo#my-skill
---

# My Agent

Instructions for the agent go here.
EOF

git init && git add . && git commit -m "Initial commit"
gh repo create my-repo --public --push

私有仓库

你的仓库可以是私有的——Buda 通过 GitHub App 安装令牌访问它。安装你列表项的用户绝不会看到你的源代码。

如果你想保护知识产权,这通常是最佳设置:

  • 买家看不到你的仓库源代码
  • 买家在购买前看不到完整的技能指令
  • 你仍然可以通过 README.md 呈现一个精美的销售/详情页
  • 你的专有实现始终保留在你的私有 GitHub 仓库中

审核与发布

Buda 采用公司级审核模式。单个列表项无法被直接发布或取消发布——它们始终跟随所属公司的状态。

公司状态列表项行为
pending从应用市场中隐藏,等待管理员审核
published所有 pending 列表项变为可见。draft 列表项被排除在外。
rejected所有列表项被隐藏

Buda 管理员在公司级别进行批准或拒绝。当一家公司获批时,只有 pending 状态的列表项会被发布——draft 状态(内容已从 GitHub 移除)的列表项会被有意排除。

更新内容时会发生什么

Buda 会索引你的仓库——它为每个列表项存储元数据(名称、描述、GitHub URL)。当用户安装技能或智能体时,Buda 会在安装时从你的 GitHub 仓库获取实际内容。

当你在做出改动后重新同步时:

  • 内容已更新 → 列表项元数据更新,状态不变,用户在下次安装时获得最新内容
  • 文件已从 GitHub 删除 → 列表项被设为 draft,从应用市场中隐藏。已安装的用户保留各自的副本。
  • 文件已恢复 → 列表项从 draft 回到 pending,等待重新审核
  • COMPANY.md 被移除(monorepo 子目录被删除)→ 公司及其所有列表项被设为 draft
  • COMPANY.md 已恢复 → 公司回到 pending,等待重新审核

草稿(draft)列表项被排除在公司审批之外。 当 Buda 管理员批准一家公司时,只有 pending 列表项会被发布。draft 列表项仍保持隐藏。

安装要求文件在 GitHub 上存在。 由于 Buda 在安装时获取内容,如果某个列表项的源文件已从 GitHub 删除,即便该列表项出现在应用市场中,安装也会失败。移除内容后请务必同步,以便受影响的列表项被设为 draft


创建仓库之后

  1. 前往 Developer Portal → Plugin Repos(开发者门户 → 插件仓库)
  2. 点击 Add Repository(添加仓库) 并选择你的仓库
  3. Buda 扫描它并创建状态为 pending 的列表项
  4. Buda 团队在 24 小时内审核并批准
  5. 你的列表项出现在应用市场中

常见错误

  • SKILL.md 当作销售页面而非指令文件
  • 发布付费技能却没有 README.md
  • 把智能体放在 agents/ 之外
  • 把团队放在 teams/ 之外
  • AGENTS.mdTEAM.md 的 frontmatter 中缺少 schema: agentcompanies/v1
  • 误以为买家在购买前能读到完整的技能内容

输出检查清单

  • 仓库结构遵循 Buda 的发现规则
  • 每个技能都有 SKILL.md
  • 商业技能还附带 README.md
  • README.md 面向买家
  • SKILL.md 面向指令
  • 每个智能体都有带 schema: agentcompanies/v1 frontmatter 的 agents/{name}/AGENTS.md
  • 每个团队都有带 schema: agentcompanies/v1 frontmatter 的 teams/{name}/TEAM.md
  • 在涉及知识产权保护的场景中考虑了私有仓库支持

相关内容

On this page