我们在做 Crewly 的时候,把 agent 的技能系统设计成了模块化的。每个技能都是一个自成一体的目录:一个描述它的 SKILL.md,加上一个运行它的脚本。这让技能很容易创建、很容易分享,也很容易安装。
Crewly Marketplace 把这种模块化变成了一个社区。浏览其他团队做的技能,一条命令装好,扩展你的 AI agent(智能体)能做的事,一行代码都不用写。
Marketplace 里有什么
Marketplace 里有三类内容:
技能
技能就是你的 agent 可以执行的操作。每个技能都是一个 bash 脚本,用来调用 API、运行工具或执行一个工作流。Crewly 自带 50 多个内置技能,Marketplace 在此基础上再加入社区贡献的技能。
现在就有的例子:
- Code Review(
code-review):分析 git 改动,生成一份结构化的代码审查,检查代码风格、复杂度、安全性和测试覆盖率 - Nano Banana Image Generation(
nano-banana-image):基于 Google Gemini 的 AI 图像生成,有标准和专业两种模型 - Send PDF to Slack(
agent-send-pdf-to-slack):把 markdown 文档转成 PDF,上传到你团队的 Slack 频道 - Playwright Chrome Browser(
playwright-chrome-browser):通过 Playwright MCP server 实现浏览器自动化:操作网页、截图、填写表单
3D 模型
Crewly 的 dashboard 支持用 3D 头像模型来表示 agent。Marketplace 里列出了 GLB 模型,让团队看起来更直观;可以在 Marketplace 里浏览。
模型附带多边形数量、贴图分辨率和可用动画等元数据,让你在安装之前就清楚自己会得到什么。
角色
角色定义了 agent 的行为方式。每个角色都包含一份系统提示词、一份分配的技能列表,以及 agent 行为配置。Marketplace 里列出了共享的角色配置,比如安全工程师;可以在 Marketplace 里浏览。
怎么安装
从 Marketplace 安装一个技能只需要一条命令:
crewly install <item-id>
比如:
# Install a skill
crewly install code-review
# See every skill you can install
crewly search
装好的技能会出现在你 agent 的技能目录里。crewly install 命令安装的是技能;3D 模型和角色请在 Marketplace 里浏览。
Crewly dashboard 里 Marketplace 页面的截图,搜索了「report」:Bug Triage、Daily Standup Report、pdf-tools 和 Test Runner 几张技能卡片,每张都有 Install 按钮。
一个刚装好的本地 Crewly 里的 Marketplace(演示数据),搜索了「report」。图中的评分和下载数是演示环境的,不代表真实使用情况。
技能在底层是怎么工作的
Crewly 自带的技能和你安装的技能,都是一个目录:里面有一个 SKILL.md,告诉 agent 什么时候、怎么用这个技能,通常还有一个 execute.sh 脚本:
skills/
└── my-skill/
├── SKILL.md # When and how the agent should use this skill
└── execute.sh # The script that runs
当 agent 需要执行某个操作时,它会带着一个 JSON 参数运行这个技能的 execute.sh:
bash config/skills/agent/my-skill/execute.sh '{"param1": "value1"}'
要把技能发布到 Marketplace,包里还需要一个 skill.json 清单(名称、版本、分类、参数)和一个 instructions.md。crewly publish 在打包前会检查 skill.json、execute.sh 和 instructions.md 这三个文件。
这种架构意味着技能是:
- 可移植的:就是一个包含
SKILL.md和一个脚本的目录 - 可测试的:直接运行 shell 脚本就能验证它是否正常工作
- 可组合的:技能可以调用其他技能,或者串联起来
- 与运行时无关的:在 Claude Code 或 Codex 上都能用
示意图:技能是怎么工作的。技能是一个目录,SKILL.md 告诉 agent 什么时候、怎么用,通常还有一个 execute.sh 脚本;agent 带着 JSON 参数运行 execute.sh;在 Claude Code 或 Codex 上都能用。
技能是怎么工作的(示意图)。
精选技能详解
Nano Banana Image Generation:AI 图像生成
Nano Banana Image Generation 技能让你的 agent 变身视觉创作者。给它一段文字提示,它会用 Google 的 Gemini 图像生成 API 生成一张图片(需要设置 GEMINI_API_KEY)。
crewly install nano-banana-image
它支持两种模型:标准(Gemini Flash)和专业(质量更高,加 --pro 参数)。很适合生成概念图、占位图片或可视化文档。
Send PDF to Slack:文档投递
这个技能处理一个常见的工作流:拿一个 markdown 文件,转成排版专业的 PDF,然后发到一个 Slack 频道。它会在第一次运行时自动安装自己需要的 Python 依赖。
crewly install agent-send-pdf-to-slack
你的 QA agent 可以生成一份测试报告,直接发到团队频道,完全不需要人工参与。
Playwright Chrome Browser:网页自动化
这个技能基于 Playwright 的 MCP server,给 agent 浏览器控制能力:打开页面、填写表单、点击元素、截图。
crewly install playwright-chrome-browser
它需要 Playwright MCP server,在 Settings 里开启浏览器自动化时 Crewly 会自动配置。也可以手动添加:npx @playwright/mcp@latest。
装好之后,agent 就能把网页交互自动化,作为工作流的一部分:抓取文档网站、测试已部署的 UI,或者操作基于网页的工具。
为 Marketplace 做贡献
想分享你做的技能?流程很简单:
- 按结构组织你的技能,包含发布所需的三个文件(
skill.json、instructions.md、execute.sh) - 在本地测试,用示例输入运行 execute 脚本
- 校验并打包:运行
crewly publish <path-to-skill> --dry-run - 提交:运行
crewly publish <path-to-skill> --submit,它会从你的 GitHub 账号开一个 PR,把技能加到config/skills/agent/marketplace/下,元数据写在skill.json里
我们会从质量、安全性和实用性几方面审核提交的内容。通过审核的技能会出现在 Marketplace 里,供所有 Crewly 用户使用。
常见问题
怎么从 Crewly Marketplace 安装技能?
运行 crewly install <item-id>,例如 crewly install code-review。想看所有可安装的技能,运行 crewly search。装好的技能会出现在你 agent 的技能目录里。
发布一个技能之前,它需要哪些文件?
三个:skill.json(清单)、execute.sh(脚本)和 instructions.md。crewly publish 在打包前会检查这三个文件。Crewly 自带的技能和从 Marketplace 安装的技能,用的是一个 SKILL.md 加上它的脚本。
我的团队怎么分享自己的 agent 技能?
给技能准备好这三个文件,在本地测试,用 crewly publish <path-to-skill> --dry-run 校验并打包,再用 crewly publish <path-to-skill> --submit 提交。这会开一个 pull request,通过审核的技能会出现在 Marketplace 里,供所有 Crewly 用户使用。
技能也能在 Codex 上用吗?
能。技能与运行时无关:在 Claude Code 和 Codex 上都能用。
接下来会有什么
我们正在做几项 Marketplace 改进:
- 在网页界面一键安装:直接在 dashboard 里安装技能,不用走 CLI
- 技能评分和评价:帮助社区把最好的技能挑出来
- 技能包:为常见工作流预先配好的技能组合(比如 "Full-Stack Dev Kit"、"QA Pipeline")
- 私有 Marketplace:把你团队的内部技能放在私有仓库里
第一次用 Crewly?先看快速上手指南,或者读完整教程,了解创建一支多 agent 团队的详细步骤。想知道一支团队能承担哪些工作,可以看看 AI Agent 团队的五个使用场景。
浏览 Marketplace
访问 Crewly Marketplace,浏览现有的技能、模型和角色。可以按分类筛选、按关键词搜索,或者按热度排序,找到你需要的东西。
Crewly Marketplace 是一个汇集 agent 技能、3D 头像模型和角色配置的社区中心。技能是可移植的 shell 脚本,在所有支持的运行时上都能用,比如 Claude Code 和 Codex。用
crewly install <item-id>安装一个技能,它就会出现在你 agent 的技能目录里。
有技能的想法,或者想参与贡献?去 Crewly GitHub 仓库看看怎么开始。