zilliztech · richzw · Mar 27, 2026
diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
@@ -0,0 +1,13 @@
+{
+  "name": "milvus-skill",
+  "version": "1.0.0",
+  "description": "Teach LLMs to use pymilvus for Milvus vector database — connection, collections, vector CRUD, search, hybrid search, full-text search, indexing, partitions, databases, and RBAC.",
+  "author": {
+    "name": "zilliztech",
+    "url": "https://github.com/zilliztech"
+  },
+  "homepage": "https://github.com/zilliztech/milvus-skill",
+  "repository": "https://github.com/zilliztech/milvus-skill",
+  "license": "Apache-2.0",
+  "keywords": ["milvus", "vector-database", "pymilvus", "rag", "semantic-search", "hybrid-search"]
+}
diff --git a/README.md b/README.md
@@ -1,11 +1,11 @@
 # milvus-skill
 
-An agent skill that teaches LLMs how to use [pymilvus](https://github.com/milvus-io/pymilvus) to operate [Milvus](https://milvus.io/) vector database.
+A Claude Code plugin that teaches LLMs how to use [pymilvus](https://github.com/milvus-io/pymilvus) to operate [Milvus](https://milvus.io/) vector database.
 
 ## What's Included
 
-- **SKILL.md** — Main skill definition with connection, collection management, vector operations, and index management
-- **references/** — Detailed reference docs for each feature area:
+- **skills/milvus/SKILL.md** — Main skill definition with connection, collection management, vector operations, and index management
+- **skills/milvus/references/** — Detailed reference docs for each feature area:
   - `collection.md` — Data types, schema fields, collection operations
   - `vector.md` — Insert, search, hybrid search, full-text search, iterators, filters
   - `index.md` — Index types, metric types, create/manage indexes
@@ -14,12 +14,32 @@ An agent skill that teaches LLMs how to use [pymilvus](https://github.com/milvus
   - `user-role.md` — RBAC: users, roles, privileges
   - `patterns.md` — Common patterns (RAG, semantic search, hybrid search, full-text search)
 
-## Install as Claude Code Skill
+## Install as Claude Code Plugin
+
+**Option 1: Via marketplace (recommended)**
+
+First add this repo as a marketplace source, then install the plugin:
+
+```
+/plugin marketplace add zilliztech/milvus-skill
+/plugin install milvus-skill@zilliztech-milvus-skill
+```
+
+**Option 2: Via CLI**
 
 ```bash
-claude skill add --url https://github.com/zilliztech/milvus-skill
+claude plugin marketplace add zilliztech/milvus-skill
+claude plugin install milvus-skill@zilliztech-milvus-skill
 ```
 
+**Option 3: Local development**
+
+```bash
+claude --plugin-dir ./milvus-skill
+```
+
+Once installed, the skill is available as `/milvus-skill:milvus`.
+
 ## Capabilities
 
 - Connect to Milvus Lite, Standalone, Cluster, or Zilliz Cloud

diff --git a/SKILL.md → skills/milvus/SKILL.md b/SKILL.md → skills/milvus/SKILL.md
diff --git a/references/collection.md → skills/milvus/references/collection.md b/references/collection.md → skills/milvus/references/collection.md
diff --git a/references/database.md → skills/milvus/references/database.md b/references/database.md → skills/milvus/references/database.md
diff --git a/references/index.md → skills/milvus/references/index.md b/references/index.md → skills/milvus/references/index.md
diff --git a/references/partition.md → skills/milvus/references/partition.md b/references/partition.md → skills/milvus/references/partition.md
diff --git a/references/patterns.md → skills/milvus/references/patterns.md b/references/patterns.md → skills/milvus/references/patterns.md
diff --git a/references/user-role.md → skills/milvus/references/user-role.md b/references/user-role.md → skills/milvus/references/user-role.md
diff --git a/references/vector.md → skills/milvus/references/vector.md b/references/vector.md → skills/milvus/references/vector.md