创建技能 / 智能体 / 团队仓库
如何组织 GitHub 仓库结构,让 Buda 能够发现并发布你的技能、智能体和团队
Buda 会扫描你的 GitHub 仓库,并根据你放置特定清单文件的位置自动发现技能、智能体和团队。
前往 agentskills.io 和 agentcompanies.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 informationFrontmatter 字段:
| 字段 | 必需 | 描述 |
|---|---|---|
schema | ✓ | 必须为 agentcompanies/v1 |
name | ✓ | 在应用市场中显示的名称 |
slug | ✓ | 稳定标识符,与目录名一致 |
description | ✓ | 列表项卡片上的一句话摘要 |
skills | ✓ | 以 repo#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。
创建仓库之后
- 前往 Developer Portal → Plugin Repos(开发者门户 → 插件仓库)
- 点击 Add Repository(添加仓库) 并选择你的仓库
- Buda 扫描它并创建状态为
pending的列表项 - Buda 团队在 24 小时内审核并批准
- 你的列表项出现在应用市场中
常见错误
- 把
SKILL.md当作销售页面而非指令文件 - 发布付费技能却没有
README.md - 把智能体放在
agents/之外 - 把团队放在
teams/之外 AGENTS.md或TEAM.md的 frontmatter 中缺少schema: agentcompanies/v1- 误以为买家在购买前能读到完整的技能内容
输出检查清单
- 仓库结构遵循 Buda 的发现规则
- 每个技能都有
SKILL.md - 商业技能还附带
README.md README.md面向买家SKILL.md面向指令- 每个智能体都有带
schema: agentcompanies/v1frontmatter 的agents/{name}/AGENTS.md - 每个团队都有带
schema: agentcompanies/v1frontmatter 的teams/{name}/TEAM.md - 在涉及知识产权保护的场景中考虑了私有仓库支持