diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
new file mode 100644
index 000000000..3ee3e5828
--- /dev/null
+++ b/.claude-plugin/marketplace.json
@@ -0,0 +1,20 @@
+{
+  "name": "cmux",
+  "owner": {
+    "name": "Manaflow AI",
+    "url": "https://github.com/manaflow-ai"
+  },
+  "metadata": {
+    "description": "Official Claude Code skills for cmux terminal multiplexer"
+  },
+  "plugins": [
+    {
+      "name": "cmux",
+      "source": {
+        "source": "url",
+        "url": "https://github.com/manaflow-ai/cmux.git"
+      },
+      "description": "Window management, browser automation, and markdown viewing skills for cmux"
+    }
+  ]
+}
diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
new file mode 100644
index 000000000..6861f8ca7
--- /dev/null
+++ b/.claude-plugin/plugin.json
@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-plugin.json",
+  "name": "cmux",
+  "version": "0.1.0",
+  "description": "Claude Code skills for cmux terminal multiplexer — window management, browser automation, and markdown viewing",
+  "repository": "https://github.com/manaflow-ai/cmux",
+  "homepage": "https://cmux.dev",
+  "license": "MIT",
+  "keywords": ["terminal", "multiplexer", "tmux", "window-management", "browser", "markdown"],
+  "skills": [
+    "./skills/cmux",
+    "./skills/cmux-browser",
+    "./skills/cmux-markdown"
+  ],
+  "author": {
+    "name": "Manaflow AI",
+    "url": "https://github.com/manaflow-ai"
+  }
+}
diff --git a/README.md b/README.md
index 8cdae0d64..2fed10fb4 100644
--- a/README.md
+++ b/README.md
@@ -116,6 +116,15 @@ brew upgrade --cask cmux
 
 On first launch, macOS may ask you to confirm opening an app from an identified developer. Click **Open** to proceed.
 
+### Claude Code Plugin
+
+Install the cmux skills for Claude Code to give your agent control over windows, panes, browser panels, and markdown viewers:
+
+```bash
+/plugin marketplace add manaflow-ai/cmux
+/plugin install cmux@cmux
+```
+
 ## Why cmux?
 
 I run a lot of Claude Code and Codex sessions in parallel. I was using Ghostty with a bunch of split panes, and relying on native macOS notifications to know when an agent needed me. But Claude Code's notification body is always just "Claude is waiting for your input" with no context, and with enough tabs open I couldn't even read the titles anymore.