Agent skills for building search, RAG, document parsing, search-grounded completions, and agent harnesses with Mixedbread. Compatible with Claude Code, Cursor, Codex, Gemini CLI, and 20+ other agents.

Installation

Install all skills with one command (works with Claude Code, Cursor, Codex, Gemini CLI, and more):

npx skills add mixedbread-ai/skills

Or install globally for all projects:

npx skills add mixedbread-ai/skills -g

Browse on the registry: skills.sh/mixedbread-ai/skills

Updating

Installations are snapshots of the skill source at installation time. To check for and install updates from the repository:

npx skills check
npx skills update

Platform-Specific Alternatives

claude install-skill mixedbread-ai/skills mxbai-cli
claude install-skill mixedbread-ai/skills mixedbread-search
claude install-skill mixedbread-ai/skills mixedbread-parsing
claude install-skill mixedbread-ai/skills mixedbread-search-agent
claude install-skill mixedbread-ai/skills mixedbread-search-agent-harness

This repo ships as a Cursor marketplace with five separately-installable plugins (mxbai-cli, mixedbread-search, mixedbread-parsing, mixedbread-search-agent, mixedbread-search-agent-harness). Install from the Cursor marketplace, or test locally by cloning into ~/.cursor/plugins/local:

git clone https://github.com/mixedbread-ai/skills ~/.cursor/plugins/local/mixedbread-skills

Cursor reads .cursor-plugin/marketplace.json at the repo root.

cp agents/AGENTS.md .agents/AGENTS.md

Reference the gemini-extension.json for extension configuration, or use the .mcp.json for MCP server integration.

Available Skills

Skill Description
mxbai-cli Manage stores, upload files, search, and sync using the mxbai CLI
mixedbread-search Create and search managed knowledge bases using the Stores API and SDKs
mixedbread-parsing Parse documents, extract structured content, and run OCR using the Parsing API
mixedbread-search-agent Call Mixedbread's Toast-1 search model through the Chat Completions API
mixedbread-search-agent-harness Build the loop around Toast-1: rounds, parallelism, evidence handles, pruning

See SKILL_TREE.md for a navigable index of all skills.

Repository Structure

mixedbread-skills/
├── .claude-plugin/          # Claude Code plugin config
├── .cursor-plugin/          # Cursor plugin config
├── .mcp.json                # MCP server config
├── gemini-extension.json    # Gemini CLI extension
├── agents/AGENTS.md         # Codex fallback
├── CLAUDE.md                # Project conventions
├── SKILL_TREE.md            # Navigable skill index
├── README.md
├── LICENSE
└── skills/
    ├── mxbai-cli/           # CLI tool usage
    ├── mixedbread-search/   # Stores API & SDKs
    ├── mixedbread-parsing/  # Parsing API & OCR
    ├── mixedbread-search-agent/ # Chat Completions API, tool contracts & Stores wiring
    └── mixedbread-search-agent-harness/ # Custom search-model harness design

Links

License

Apache-2.0 — see LICENSE.