{
  "markdown": "# Couchbase Agent Skills\n\nCouchbase agent skills bring Couchbase expertise to your agents out of the box, letting them operate from authoritative knowledge rather than relying on training data or guesswork. Designed with the enterprise-supported Couchbase MCP server, these skills work against a real, live cluster — grounding every answer in your actual schema, data, and indexes so agents deliver reliable, high-quality results.\n\nEnterprise support for Couchbase MCP Server is available by licensing Couchbase AI Data Plane, which also entitles use and enterprise support of Couchbase Agent Memory and Couchbase Agent Catalog.\n\n## Available Skills\n\n| Skill Name | What it does |\n|------------|--------------|\n| `couchbase-mcp-setup` | **Initial configuration:** setting CB_* environment variables for the MCP server environment. |\n| `couchbase-natural-language-querying` | Translating natural language into SQL++ for execution against live cluster environments. |\n| `couchbase-query-optimizer` | Optimization of EXPLAIN plans, GSI index architecture, and identifying slow query bottlenecks. |\n| `couchbase-data-modeling` | Schema design for JSON, evaluating embedding vs. referencing strategies, and defining document key patterns. |\n\n## Prerequisites\n\nThe skills act on a live cluster through the [Couchbase MCP server](https://github.com/couchbase/mcp-server-couchbase) which can be installed via [`uv`](https://docs.astral.sh/uv/) (`uvx`) or Docker. For first-time configuration, use the `couchbase-mcp-setup` skill, or see the [MCP server docs](https://github.com/couchbase/mcp-server-couchbase#readme).\n\n## Installation methods\n\nThe repo at [`Couchbase-Ecosystem/agent-skills`](https://github.com/Couchbase-Ecosystem/agent-skills) is itself the plugin / marketplace source — install directly from it:\n\n| Harness | Install |\n|---|---|\n| **Claude Code** | Within a Claude Code session: `/plugin marketplace add Couchbase-Ecosystem/agent-skills`, then `/plugin install couchbase@couchbase-plugins` |\n| **Claude Desktop App** | In **Customize**, click the `+` next to **Personal Plugins** → **Add** → **Add Marketplace**, enter `Couchbase-Ecosystem/agent-skills` (or the repo URL), and click **Sync**. Then click the `+` to install the **couchbase** plugin. _No marketplace flow in your UI? [Install each skill manually](#install-each-skill-manually-claude-desktop) below._ |\n| **Codex CLI** | `codex plugin marketplace add Couchbase-Ecosystem/agent-skills`, then start `codex` and open the plugins browser `/plugins`. Find the `couchbase` plugin and install. |\n| **Codex Desktop App** | Go to **Plugins** → click the dropdown next to the `+` (top-right) → **Add marketplace**, enter `Couchbase-Ecosystem/agent-skills` as the source, and click **Add marketplace**. Then on the **Plugins → Personal** tab, click **Install** next to **Couchbase**. |\n| **Antigravity CLI** | `agy plugin install https://github.com/Couchbase-Ecosystem/agent-skills` |\n| **Gemini CLI** | `gemini extensions install https://github.com/Couchbase-Ecosystem/agent-skills` |\n| **GitHub Copilot CLI** | Within a Copilot CLI session: `/plugin marketplace add Couchbase-Ecosystem/agent-skills`, then `/plugin install couchbase@couchbase-plugins` (restart to activate the MCP server) |\n| **Cursor** | Add `Couchbase-Ecosystem/agent-skills` as a plugin marketplace, then install `couchbase` via `/add-plugin` or the marketplace UI |\n\nAfter installing, run the **`couchbase-mcp-setup`** skill to connect to your cluster — it walks you through setting the `CB_*` environment variables (`CB_CONNECTION_STRING`, `CB_USERNAME`, `CB_PASSWORD`) per harness.\n\n### Install each skill manually (Claude Desktop)\n\nIf your Claude Desktop UI does not show the plugin marketplace flow, use per-skill uploads instead.\n\n1. **Create one ZIP per skill** (from repo root):\n   ```bash\n   mkdir -p skill-zips\n   for d in skills/*; do\n     [ -d \"$d\" ] || continue\n     name=\"$(basename \"$d\")\"\n     [ \"$name\" = \"_template\" ] && continue\n     zip -r \"skill-zips/${name}.zip\" \"$d\"\n   done\n   ```\n2. **Upload each skill ZIP in Claude Desktop.** For each file in `skill-zips/`, go to **Customize → Skills → + icon → Create Skill → Upload a Skill**.\n3. **Set up the MCP server separately.** Per-skill uploads do not include the bundled MCP server wiring, so follow the quickstart here: https://mcp-server.couchbase.com/get-started/quickstart\n\n## Contributing\n\nAuthoring, validating, and testing skills is documented in\n[`CONTRIBUTING.md`](./CONTRIBUTING.md). For testing specifics — eval suites and\nthe [harness sandbox](./testing/sandbox/README.md) — see [`testing/`](./testing/README.md).\n\n## License\n\nApache-2.0. See [`LICENSE`](./LICENSE).\n",
  "bytes": 4686,
  "sha": "91c12ff86e3c504196111eddf523d25bdfaffe0a582096a07b6b9b07d5afce83",
  "repo_slug": "couchbase-ecosystem/agent-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_couchbase_ecosystem_agent_skills_e2428afd/readme"
}