diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
new file mode 100644
index 0000000..49da0c1
--- /dev/null
+++ b/.claude-plugin/marketplace.json
@@ -0,0 +1,15 @@
+{
+  "name": "supercrew-dev",
+  "description": "Development marketplace for SuperCrew plugin — AI-driven feature lifecycle management",
+  "owner": {
+    "name": "steinsz"
+  },
+  "plugins": [
+    {
+      "name": "supercrew",
+      "description": "AI-driven feature lifecycle management. Creates and manages .supercrew/features/ directories with meta.yaml, design.md, plan.md, and log.md for structured feature development.",
+      "version": "0.1.0",
+      "source": "./plugins/supercrew"
+    }
+  ]
+}
diff --git a/README.md b/README.md
index 361e806..b8e5e4d 100644
--- a/README.md
+++ b/README.md
@@ -11,14 +11,11 @@ AI-driven feature lifecycle management. Track features from idea to done using s
 **Install in Claude Code:**
 
 ```bash
-# 1. Add the local marketplace (use absolute path)
-/plugin marketplace add /path/to/supercrew/plugins/supercrew
+# 1. Add the marketplace
+/plugin marketplace add iamtouchskyer/supercrew
 
 # 2. Install the plugin
 /plugin install supercrew@supercrew-dev
-
-# 3. Verify
-/plugin list
 ```
 
 **Commands:**
diff --git a/plugins/supercrew/README.md b/plugins/supercrew/README.md
index b842b97..8d5defe 100644
--- a/plugins/supercrew/README.md
+++ b/plugins/supercrew/README.md
@@ -1,79 +1,10 @@
 # SuperCrew Plugin
 
-AI-driven feature lifecycle management for Claude Code. Track features from idea to done using structured `.supercrew/features/` directories.
+See the [main README](../../README.md) for installation and usage.
 
-## Quick Start
+## Plugin Internals
 
-### 1. Install the plugin
-
-```bash
-# In Claude Code, run these 3 commands in order:
-
-# 1) Add the local marketplace (use absolute path to plugins/supercrew)
-/plugin marketplace add /path/to/supercrew/plugins/supercrew
-
-# 2) Install the plugin from the local marketplace
-/plugin install supercrew@supercrew-dev
-
-# 3) Verify installation — you should see supercrew listed
-/plugin list
-```
-
-> Replace `/path/to/supercrew` with the actual absolute path to your supercrew repo clone.
-
-**Reinstall / Update:**
-
-```bash
-/plugin uninstall supercrew@supercrew-dev
-/plugin marketplace remove supercrew-dev
-/plugin marketplace add /path/to/supercrew/plugins/supercrew
-/plugin install supercrew@supercrew-dev
-```
-
-### 2. Create your first feature
-
-```
-/supercrew:new-feature
-```
-
-This creates `.supercrew/features/<feature-id>/` with four files:
-
-| File | Purpose |
-|---|---|
-| `meta.yaml` | ID, title, status, priority, owner, dates |
-| `design.md` | Requirements, architecture, constraints |
-| `plan.md` | Task breakdown with checklist & progress |
-| `log.md` | Chronological progress entries |
-
-### 3. Work on a feature
-
-```
-/supercrew:work-on <feature-id>
-```
-
-Or simply check out a matching branch — the SessionStart hook auto-detects `feature/<id>` branches:
-
-```bash
-git checkout -b feature/my-feature
-```
-
-### 4. Check status
-
-```
-/supercrew:feature-status
-```
-
-Displays a table of all tracked features with status, priority, and progress.
-
-## Feature Lifecycle
-
-```
-planning → designing → ready → active → blocked → done
-                                  ↑         |
-                                  └─────────┘
-```
-
-## Skills
+### Skills
 
 | Skill | Triggers on |
 |---|---|
@@ -84,14 +15,6 @@ planning → designing → ready → active → blocked → done
 | **log-progress** | Recording what was done |
 | **managing-features** | Auto-orchestrates lifecycle when `.supercrew/features/` exists |
 
-## Commands
-
-| Command | Description |
-|---|---|
-| `/supercrew:new-feature` | Create a new feature |
-| `/supercrew:feature-status` | Show all features status |
-| `/supercrew:work-on` | Switch active feature for this session |
-
-## Hooks
+### Hooks
 
 - **SessionStart** — Scans `.supercrew/features/`, shows summary table, auto-loads active feature context based on current git branch.