add agents plugin manifest

Author: ldoguin

.agents/plugins/marketplace.json

@@ -0,0 +1,22 @@
+{
+  "name": "couchbase-agent-skills",
+  "interface": {
+    "displayName": "Couchbase Agent Skills"
+  },
+  "plugins": [
+    {
+      "name": "couchbase-skills",
+      "source": {
+        "source": "git-subdir",
+        "url": "https://github.com/couchbaselabs/agent-skills.git",
+        "path": ".",
+        "ref": "main"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL"
+      },
+      "category": "Productivity"
+    }
+  ]
+}

.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "couchbase-skills",
+  "version": "1.0.0",
+  "description": "Couchbase agent skills for Claude Code — connection, querying, search, transactions, analytics, FLE, mobile, and more across 9 SDK languages.",
+  "author": {
+    "name": "Couchbase Labs",
+    "url": "https://github.com/couchbaselabs/agent-skills"
+  }
+}

.codex-plugin/plugin.json

@@ -0,0 +1,22 @@
+{
+  "name": "couchbase-skills",
+  "version": "1.0.0",
+  "description": "Couchbase agent skills for Codex — connection, querying, search, transactions, analytics, FLE, mobile, and more across 9 SDK languages.",
+  "author": {
+    "name": "Couchbase Labs",
+    "url": "https://github.com/couchbaselabs/agent-skills"
+  },
+  "homepage": "https://github.com/couchbaselabs/agent-skills",
+  "repository": "https://github.com/couchbaselabs/agent-skills",
+  "license": "Apache-2.0",
+  "keywords": ["couchbase", "database", "nosql", "sdk", "mobile"],
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "Couchbase Skills",
+    "shortDescription": "Couchbase SDK skills for connection, querying, search, transactions, analytics, FLE, and mobile across 9 languages.",
+    "developerName": "Couchbase Labs",
+    "category": "Productivity",
+    "capabilities": ["Read"],
+    "websiteURL": "https://github.com/couchbaselabs/agent-skills"
+  }
+}

README.md

@@ -4,15 +4,41 @@ A collection of agent skills for working with Couchbase. Each skill teaches an A
 
 Skills follow the [Agent Skills](https://agentskills.dev) specification.
 
-## Usage
+## Installation
+
+### Claude Code
+
+Install [Claude Code](https://claude.ai/install), then install this plugin from your project directory:
+
+```bash
+claude
+/plugin install github:couchbaselabs/agent-skills
+```
+
+### Codex
 
-Load a skill when working on a Couchbase-related task. The agent reads the skill's `SKILL.md` and follows its workflow, loading reference files on demand.
+Install [Codex](https://developers.openai.com/codex), then add the marketplace to your project:
+
+```bash
+codex plugin marketplace add couchbaselabs/agent-skills
+```
+
+Or add it to your project's `.agents/plugins/marketplace.json` manually — a starter file is included in this repo at `.agents/plugins/marketplace.json`.
+
+Once installed in either agent, skills activate automatically based on what you ask. You can also load one explicitly:
 
 ```
-# Example: use the Go connection skill
 read_skill("server-connection-go")
 ```
 
+### Other agents (Cursor, Copilot, etc.)
+
+Clone the repo and point your agent at `AGENTS.md` — it's the coding-agent configuration file and is read automatically by agents that support it.
+
+## Usage
+
+Skills activate automatically when you ask a Couchbase-related question. The agent reads the matching skill's `SKILL.md` and follows its workflow, loading reference files on demand.
+
 Skills hand off to each other automatically — for example, a connection skill routes to the querying skill when you ask about SQL++, and to the sdk-patterns skill when you ask about CAS or bulk operations.
 
 ## Structure