From 6151ff54b1bc26ad25b82387746b737af8d7bac8 Mon Sep 17 00:00:00 2001
From: Wei Zang <richzw@gmail.com>
Date: Thu, 26 Mar 2026 23:20:12 -0700
Subject: [PATCH] feat: Restructure as Claude Code plugin for marketplace
 installation

---
 .claude-plugin/plugin.json                    | 13 ++++++++
 README.md                                     | 30 +++++++++++++++----
 SKILL.md => skills/milvus/SKILL.md            |  0
 .../milvus/references}/collection.md          |  0
 .../milvus/references}/database.md            |  0
 .../milvus/references}/index.md               |  0
 .../milvus/references}/partition.md           |  0
 .../milvus/references}/patterns.md            |  0
 .../milvus/references}/user-role.md           |  0
 .../milvus/references}/vector.md              |  0
 10 files changed, 38 insertions(+), 5 deletions(-)
 create mode 100644 .claude-plugin/plugin.json
 rename SKILL.md => skills/milvus/SKILL.md (100%)
 rename {references => skills/milvus/references}/collection.md (100%)
 rename {references => skills/milvus/references}/database.md (100%)
 rename {references => skills/milvus/references}/index.md (100%)
 rename {references => skills/milvus/references}/partition.md (100%)
 rename {references => skills/milvus/references}/patterns.md (100%)
 rename {references => skills/milvus/references}/user-role.md (100%)
 rename {references => skills/milvus/references}/vector.md (100%)

diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
new file mode 100644
index 0000000..33d3e5b
--- /dev/null
+++ 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
index 180d9b2..86e2d55 100644
--- 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 b/skills/milvus/SKILL.md
similarity index 100%
rename from SKILL.md
rename to skills/milvus/SKILL.md
diff --git a/references/collection.md b/skills/milvus/references/collection.md
similarity index 100%
rename from references/collection.md
rename to skills/milvus/references/collection.md
diff --git a/references/database.md b/skills/milvus/references/database.md
similarity index 100%
rename from references/database.md
rename to skills/milvus/references/database.md
diff --git a/references/index.md b/skills/milvus/references/index.md
similarity index 100%
rename from references/index.md
rename to skills/milvus/references/index.md
diff --git a/references/partition.md b/skills/milvus/references/partition.md
similarity index 100%
rename from references/partition.md
rename to skills/milvus/references/partition.md
diff --git a/references/patterns.md b/skills/milvus/references/patterns.md
similarity index 100%
rename from references/patterns.md
rename to skills/milvus/references/patterns.md
diff --git a/references/user-role.md b/skills/milvus/references/user-role.md
similarity index 100%
rename from references/user-role.md
rename to skills/milvus/references/user-role.md
diff --git a/references/vector.md b/skills/milvus/references/vector.md
similarity index 100%
rename from references/vector.md
rename to skills/milvus/references/vector.md