1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | mixedbread-ai-mixedbread-ai-skills | — |
| 项目自述名称 | Mixedbread Skills | GitHub README |
| 作者/维护者 | Mixedbread（AI 搜索与文档解析平台厂商），官方组织仓库 | GitHub API |
| 来源链接 | https://github.com/mixedbread-ai/skills | — |
| 许可证 | Apache-2.0 | GitHub API + LICENSE 原文核对 |
| GitHub Stars | 6 | GitHub API |
| Forks | 1 | GitHub API |
| 最新版本 | 1.0.0（.claude-plugin/plugin.json） |
GitHub |
| 安装方式 | npx skills add mixedbread-ai/skills（一键装全部三个子技能） |
官方 README |
2. 功能介绍与亮点
Mixedbread Skills 是官方 Mixedbread 团队维护的技能合集，把“检索增强生成（RAG）“全链路拆成三个协同子技能：
- mixedbread-search：创建与查询托管知识库（Store），支持文本/图像/表格/音频/视频等多模态语义搜索、多步 agentic 检索、按元数据过滤、结果重排与网页搜索联动。
- mixedbread-parsing：解析 PDF、Word、PowerPoint 与图片，运行 OCR，提取带坐标框与置信度的结构化内容，可转换为 Markdown 或 HTML。
- mxbai-cli：命令行管理 Store、上传文件、执行搜索与目录同步，适合接入 CI/CD 流水线。
三个技能共享同一套 Mixedbread 云端 API，全部由官方账号（2023 年创建，公司主页 mixedbread.com）维护，代码库为 Apache-2.0 开源协议，多名具名员工（Joel Dierkes、Naing Linn Khant 等）持续提交，最近一次提交为今日。每个 SKILL.md 均给出 Python 与 TypeScript 双语言的 Setup 与 Quick Start 示例，并附有 SKILL_TREE.md 导航索引。
3. 适用场景
所属分类：集成与工作流自动化
需要在 Claude Code、Cursor、Codex 等编程 Agent 里快速接入一套全托管语义搜索与文档解析能力的开发者——无需自建向量数据库或 OCR 流水线，适合构建产品知识库问答、客服文档检索、批量合同/报告解析等场景的初中级用户与小团队。
4. 跨 Agent 兼容性
- Claude Code：原生支持——README 提供
claude install-skill mixedbread-ai/skills <子技能名>专用安装命令。 - Codex：需适配——官方做法是手动执行
cp agents/AGENTS.md .agents/AGENTS.md，把技能内容拷进 Codex 的 AGENTS.md 惯例路径，非一键安装。 - OpenClaw：未验证——官方文档未点名。
- Hermes Agent：未验证——官方文档未点名。
（README 另提到经 skills.sh 注册表可供 20 余种 Agent 客户端发现安装，并单独支持 Cursor 与 Gemini CLI，但未点名 OpenClaw 或 Hermes Agent，故对二者不下判断。）
5. 推荐理由
官方厂商出品、维护活跃、文档结构清晰，一次安装即可让 Agent 具备“语义搜索 + 文档解析/OCR + CLI 同步”的完整 RAG 工具箱，省去自建向量库与解析流水线的门槛。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 官方厂商仓库，公司主页、Apache-2.0 许可与多名具名员工的持续提交均可核实真实性；但 GitHub 仅 6 星，暂未见第三方独立讨论，品牌规模不及头部厂商 |
| 可用性 | 8 | 一条 npx 命令装全部三个子技能，SKILL.md 含双语言示例与统一的 Setup/Quick Start 结构，代码库当日仍有提交；需注册 Mixedbread 账号并配置 API Key（有免信用卡的免费额度） |
| 安全性 | 8 | 见下方安全检查清单 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行范围 | mxbai-cli 仅执行官方 CLI 自身命令（建库、上传、搜索、同步），权限范围清楚且与功能直接对应 |
| ② 运行时联网外发 | 会将查询与待解析文档发送至 Mixedbread 云端 API，文档中已明确说明，属产品本身必需的数据流向 |
| ③ API Key 存储 | 通过环境变量 MXBAI_API_KEY 或 CLI 配置文件保存，方式清楚、与行业惯例一致 |
| ④ 可疑指令 | 三份 SKILL.md 均为常规技术文档，未发现隐蔽指令或混淆代码 |
| ⑤ 作者信誉 | 官方组织账号，公司主页、多名具名员工数月持续提交，无造假迹象 |
| ⑥ License | Apache-2.0，条款明确 |
| ⑦ 维护时间 | 最近提交为今日，活跃维护 |
综合评分 = 三项均值 = 7.7。
7. 跟同类 Skills 相比的优势
| 项目 | 技术路线 | 与 Mixedbread Skills 的差异 |
|---|---|---|
| pgvector-semantic-search（Timescale） | 基于 PostgreSQL 的 pgvector 扩展 | 开源自托管，需要自行部署数据库、管理索引参数与扩容；免云端费用但运维成本在自己团队 |
| qdrant-advisor（Qdrant） | 开源向量数据库 Qdrant | 同样需要自建/自托管 Qdrant 实例，偏向已有基础设施、想优化查询与部署的团队 |
Mixedbread Skills 走的是相反路线：全托管 SaaS API，免运维、开箱即用，额外内置 OCR 文档解析能力（PDF/Word/PPT），但需按用量付费，且数据经第三方云端处理，不适合对数据出境有严格限制的场景。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价，GitHub 仓库自身的 Issue 记录也仅有一条团队内部的重构提案。
9. 其他补充
三个子技能均提供 Python 与 TypeScript 双语言 SDK 示例；仓库同时以 Cursor 插件市场条目、Gemini CLI 扩展配置形式发布，覆盖多种安装渠道。
10. 安装使用方式
- 通用（推荐）：
npx skills add mixedbread-ai/skills，或加-g参数全局安装。 - Claude Code 单独安装子技能：
claude install-skill mixedbread-ai/skills mxbai-cli claude install-skill mixedbread-ai/skills mixedbread-search claude install-skill mixedbread-ai/skills mixedbread-parsing - Cursor：从 Cursor 应用市场安装，或克隆仓库到
~/.cursor/plugins/local。 - Codex：
cp agents/AGENTS.md .agents/AGENTS.md。 - Gemini CLI：参照仓库内
gemini-extension.json或.mcp.json配置。
安装后需在 https://platform.mixedbread.com 注册并获取 API Key，设置环境变量 MXBAI_API_KEY 后即可使用；无需重启 Agent，技能会在触发相关意图时自动读取。
11. 注意事项
- 使用
mixedbread-search/mixedbread-parsing需要 Mixedbread 平台账号与 API Key，属云端计费服务（有免信用卡的免费额度，超出后按量计费）。 - 文档与查询内容会上传至 Mixedbread 云端处理，涉密或强合规要求的数据上传前需自行评估。
- Codex 安装方式为手动拷贝配置文件，非一键安装；OpenClaw 与 Hermes Agent 兼容性未经验证，使用前建议先在测试环境确认。