diff --git a/skills/.claude-plugin/marketplace.json b/skills/.claude-plugin/marketplace.json
new file mode 100644
index 000000000..62aac87a1
--- /dev/null
+++ b/skills/.claude-plugin/marketplace.json
@@ -0,0 +1,43 @@
+{
+  "name": "wren",
+  "owner": {
+    "name": "Canner",
+    "email": "dev@cannerdata.com"
+  },
+  "metadata": {
+    "description": "Wren Engine skills — semantic SQL, MDL management, MCP server setup for 20+ data sources"
+  },
+  "plugins": [
+    {
+      "name": "wren",
+      "source": ".",
+      "description": "AI agent skills for Wren Engine — semantic SQL layer and MCP server for 20+ data sources.",
+      "version": "1.0.0",
+      "keywords": [
+        "wren",
+        "sql",
+        "mdl",
+        "mcp",
+        "semantic-layer",
+        "docker",
+        "amazon-s3",
+        "apache-spark",
+        "apache-doris",
+        "athena",
+        "bigquery",
+        "clickhouse",
+        "databricks",
+        "duckdb",
+        "google-cloud-storage",
+        "minio",
+        "mysql",
+        "oracle",
+        "postgres",
+        "redshift",
+        "sql-server",
+        "snowflake",
+        "trino"
+      ]
+    }
+  ]
+}
diff --git a/skills/.claude-plugin/plugin.json b/skills/.claude-plugin/plugin.json
new file mode 100644
index 000000000..178ce0252
--- /dev/null
+++ b/skills/.claude-plugin/plugin.json
@@ -0,0 +1,38 @@
+{
+  "name": "wren",
+  "description": "AI agent skills for Wren Engine — semantic SQL layer and MCP server for 20+ data sources.",
+  "version": "1.0.0",
+  "author": {
+    "name": "Canner",
+    "url": "https://www.getwren.ai/"
+  },
+  "homepage": "https://www.getwren.ai/",
+  "repository": "https://github.com/Canner/wren-engine",
+  "license": "Apache-2.0",
+  "keywords": [
+    "wren",
+    "sql",
+    "mdl",
+    "mcp",
+    "semantic-layer",
+    "data-source",
+    "docker",
+    "amazon-s3",
+    "apache-spark",
+    "apache-doris",
+    "athena",
+    "bigquery",
+    "clickhouse",
+    "databricks",
+    "duckdb",
+    "google-cloud-storage",
+    "minio",
+    "mysql",
+    "oracle",
+    "postgres",
+    "redshift",
+    "sql-server",
+    "snowflake",
+    "trino"
+  ]
+}
diff --git a/skills/README.md b/skills/README.md
index bdd3a398a..ea2a263fe 100644
--- a/skills/README.md
+++ b/skills/README.md
@@ -4,7 +4,22 @@ This directory contains reusable AI agent skills for working with Wren Engine. S
 
 ## Installation
 
-### Option 1 — npx skills (recommended)
+### Option 1 — Claude Code Plugin
+
+Add the marketplace and install:
+```
+/plugin marketplace add Canner/wren-engine --path skills
+/plugin install wren@wren
+```
+
+Or test locally during development:
+```bash
+claude --plugin-dir ./skills
+```
+
+Skills are namespaced as `/wren:<skill>` (e.g., `/wren:generate-mdl`, `/wren:wren-sql`).
+
+### Option 2 — npx skills
 
 Install all skills for Claude Code:
 ```bash
@@ -13,7 +28,7 @@ npx skills add Canner/wren-engine --skill '*' --agent claude-code
 
 `npx skills` also supports Cursor, Windsurf, and 30+ other agent tools — replace `--agent claude-code` with your agent of choice.
 
-### Option 2 — install script (from a local clone)
+### Option 3 — install script (from a local clone)
 
 ```bash
 bash skills/install.sh                        # all skills
@@ -21,7 +36,7 @@ bash skills/install.sh generate-mdl wren-sql  # specific skills
 bash skills/install.sh --force generate-mdl   # overwrite existing
 ```
 
-### Option 3 — manual copy
+### Option 4 — manual copy
 
 ```bash
 cp -r skills/wren-usage ~/.claude/skills/