diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json
new file mode 100644
index 0000000..eea484f
--- /dev/null
+++ b/.cursor-plugin/plugin.json
@@ -0,0 +1,27 @@
+{
+  "name": "kernel",
+  "displayName": "Kernel",
+  "version": "1.0.0",
+  "description": "browser infrastructure for AI agents and web automations. cloud browsers in <30ms, anti-bot stealth mode, managed auth, playwright execution, and a serverless app platform — no local chrome needed.",
+  "author": {
+    "name": "Kernel",
+    "email": "support@onkernel.com"
+  },
+  "homepage": "https://kernel.sh",
+  "repository": "https://github.com/kernel/skills",
+  "license": "MIT",
+  "logo": "assets/logo.png",
+  "keywords": [
+    "browse", "browser", "browser-automation", "web-scraping", "scrape",
+    "playwright", "cloud-browser", "mcp", "ai-agents", "screenshots",
+    "stealth", "headless", "typescript-sdk", "python-sdk", "authentication",
+    "managed-auth", "computer-use", "puppeteer", "cdp"
+  ],
+  "category": "developer-tools",
+  "tags": [
+    "browse", "browser-automation", "cloud-browsers",
+    "web-scraping", "mcp", "developer-tools"
+  ],
+  "skills": ["./plugins/kernel-cli/skills/", "./plugins/kernel-sdks/skills/"],
+  "rules": "./rules/"
+}
diff --git a/README.md b/README.md
index 6a7039c..d06e1ea 100644
--- a/README.md
+++ b/README.md
@@ -17,6 +17,16 @@ Official AI agent skills from the Kernel for installing useful skills for our CL
 /plugin install kernel-sdks
 ```
 
+### Cursor
+
+Install from the Cursor Marketplace:
+
+1. Open Cursor Settings > Plugins
+2. Search for "Kernel"
+3. Install the plugin
+
+The Cursor plugin includes all skills, an MCP server for cloud browser management, and best-practice rules.
+
 ### Any Agent
 ```bash
 npx skills add kernel/skills
diff --git a/assets/logo.png b/assets/logo.png
new file mode 100644
index 0000000..f3785fb
Binary files /dev/null and b/assets/logo.png differ
diff --git a/mcp.json b/mcp.json
new file mode 100644
index 0000000..f0d347b
--- /dev/null
+++ b/mcp.json
@@ -0,0 +1,7 @@
+{
+  "mcpServers": {
+    "kernel": {
+      "url": "https://mcp.onkernel.com/mcp"
+    }
+  }
+}
diff --git a/rules/kernel-best-practices.mdc b/rules/kernel-best-practices.mdc
new file mode 100644
index 0000000..bbc91e4
--- /dev/null
+++ b/rules/kernel-best-practices.mdc
@@ -0,0 +1,14 @@
+---
+description: best practices for kernel cloud browser automation and web scraping
+alwaysApply: false
+---
+
+- always delete browsers when done. use try/finally to guarantee cleanup.
+- set `timeout_seconds` on every browser as a safety net. default is 60s — increase for longer tasks, max is 72h.
+- use `stealth: true` when accessing any site with bot detection. stealth mode adds a recaptcha solver and residential proxy automatically.
+- use browser profiles for sites requiring authentication. set `save_profile_changes: true` to persist session changes.
+- prefer the playwright execution API (`execute_playwright_code`) for simple one-off scripts. use the SDK + CDP connection for complex multi-step automations.
+- use `headless: true` for faster execution when you don't need to watch the browser via live view.
+- proxy quality for anti-detection, best to worst: mobile > residential > ISP > datacenter.
+- no charges for idle time — only for active browser usage.
+- never hardcode credentials in automation code. use kernel's managed auth or browser profiles instead.