1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | chroma-cloud（chroma-core/agent-skills 合集内的子技能） | GitHub API / SKILL.md |
| 作者/维护者 | Chroma 官方团队（GitHub 组织 chroma-core） |
GitHub API |
| 来源链接 | https://github.com/chroma-core/agent-skills/tree/main/skills/chroma-cloud | — |
| 许可证 | MIT | GitHub API 实测 |
| GitHub Stars / Forks | 所属 agent-skills 仓库 21★ / 5 forks（该数字属整个合集仓库，不代表本技能个体热度，仅供了解仓库规模） |
GitHub API |
| 最新版本 | 仓库整体版本 2.0.2（Git Tag，非单个子技能独立编号） | GitHub API |
| 安装方式 | npx skills add 单技能安装 |
仓库 README |
2. 功能介绍与亮点
chroma-cloud 是 Chroma 官方 Agent Skills 合集中专门面向 Chroma Cloud 托管服务 的技能，帮助 agent 正确接入云端语义检索与混合检索：
- 客户端与场景判断：区分
CloudClient与本地Client的使用边界，先确认CHROMA_API_KEY/CHROMA_TENANT/CHROMA_DATABASE等云端凭据是否已配置 - API 选型指导：
query()用于纯稠密向量检索；Schema()+Search()用于需要多索引、稀疏向量或更复杂排序表达式的混合检索场景，SKILL.md 明确写出两者不可同时传参的易错点 - 云端专属能力：Collection Forking（秒级复制集合）、缓存集合引用降低重复查找请求、配额与限流说明、Chroma 托管 Qwen embedding 服务
- 双语言完整参考：TypeScript 与 Python 各配 9 篇主题文档，另有数据模型、CLI 认证与建库、既有系统接入指南等 5 篇通用文档
亮点：① 官方团队直接维护，仓库自带 bun run build/validate 流程对代码示例做自动化校验，非仅人工审校；② 与同仓库的 chroma-local 可独立安装，不强制捆绑；③ 覆盖混合检索、Collection Forking 等云端独有能力，是本地方案之外的进阶选项。
3. 适用场景
固定分类：数据分析与可视化
适合已决定或打算使用 Chroma 托管云服务做语义检索的开发者，尤其是需要混合检索（稠密+稀疏向量）、多索引配置、或 Collection Forking 等云端专属能力的场景；也适合已用过 chroma-local 、现在要把项目迁移上云的用户。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——遵循通用 Agent Skills 规范，
npx skills add为标准安装方式，仓库自带CLAUDE.md说明文件 - Codex：❓ 未验证——公开材料未点名 Codex 适配情况
- OpenClaw：❓ 未验证——公开材料未提及
- Hermes Agent：❓ 未验证——公开材料未提及
（仅基于已抓取材料判断，未为兼容性单独发起搜索）
5. 推荐理由
Chroma Cloud 集成中，CloudClient 与本地 Client 的选择、环境变量配置、Schema()/Search() 与 query() 的取舍、以及 embedding 包的安装，都是容易被 agent 凭猜测写错的细节。chroma-cloud 把这些决策沉淀成清晰的判断树，并配套双语言参考文档与自动化校验过的代码示例，适合准备把语义检索能力接入云端、又不想在 API 细节上反复试错的开发者。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | Chroma 是应用广泛的开源向量数据库（主仓库 chroma-core/chroma 2.89 万 star，GitHub API 实测），本技能由官方团队直接出品；agent-skills 子仓库本身规模较小（21 star），子目录暂未见独立第三方对该技能的专门评测 |
| 可用性 | 8 | 文档结构完整（9 组双语言参考文档 + 5 篇通用指南），仓库自带 bun run build/validate 流程校验代码示例可运行；需要注册 Chroma Cloud 账号并配置 API Key/Tenant/Database 等云端凭据，非零配置即用；最近一次提交距今约 3 个月，仍在维护窗口内 |
| 安全性 | 8 | 见下方安全检查清单 |
| 综合 | 8.0 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行范围 | 仅涉及 chroma login、chroma db create、chroma db connect 等 CLI 认证与建库操作，范围明确 |
| ② 运行时联网外发数据 | 按设计需连接 Chroma 官方云服务（CHROMA_API_KEY/CHROMA_TENANT/CHROMA_DATABASE），外发目标是产品本身、公开透明，非隐藏行为 |
| ③ API Key/凭据 | 通过环境变量配置，SKILL.md 明确要求先核实凭据是否已配置，无额外收集或硬编码行为 |
| ④ 可疑指令 | 逐一审阅 SKILL.md 与各主题参考文档，内容均为客户端用法与决策指导，未发现 prompt injection 或异常指令 |
| ⑤ 作者/组织信誉 | 官方 Chroma 团队账号出品，无刷星或 SEO 操纵迹象 |
| ⑥ License | MIT，明确 |
| ⑦ 最近维护时间 | 最近提交距今约 3 个月，仍在活跃窗口内 |
7. 跟同类 Skills 相比的优势
| 竞品 | 定位 | 与本技能的差异 |
|---|---|---|
| pinecone-quickstart（Pinecone 官方） | Pinecone 托管向量数据库的入门向导，Database/Assistant 双路径，自动生成示例数据兜底新手无数据场景 | 定位在“从零上手”的入门引导；chroma-cloud 更聚焦已确定技术选型后的具体 API 决策（客户端选型、Schema 与 Search API、混合检索取舍） |
| chroma-local（同仓库姊妹技能） | 面向本地自托管 Chroma，无需账号、完全免费运行 | 与 chroma-cloud 分别覆盖“本地零依赖”与“云端托管混合检索”两种部署形态，功能面互补而非竞争，用户按实际部署方式选择安装 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价；部分技能目录站（如 LobeHub）收录了其功能说明列表，属目录索引性质，非评测内容。
9. 其他补充
技能提交历史显示三次迭代均由同一位官方维护者完成：先拆分本地/云端为两个独立技能，再补充缓存集合引用说明，最后补齐 rank/score 排序细节——迭代方向均来自维护者自行归纳的功能缺口，而非外部 issue 驱动。
10. 安装使用方式
npx skills add chroma-core/agent-skills --skill "chroma-cloud"安装后无需重启，直接在对话中提出“用 Chroma Cloud 做混合检索”等需求即可触发本技能引导。使用前需已完成 chroma login 认证并创建好目标数据库（chroma db create <db_name>），否则技能会先引导补齐这些前置步骤。
11. 注意事项
- 依赖 Chroma 官方云服务，非完全免费的本地方案；若不希望数据经过云端或不想承担 Cloud 账号成本，应改用同仓库的
chroma-local - 跨 Agent 兼容性仅验证 Claude Code，其余三个生态未验证
- 安全检查清单第 ②③ 项：数据与凭据均会流向 Chroma 官方云服务，涉及数据合规要求的团队需自行评估是否符合内部云存储规范