feat: restructure repo as Claude Code plugin marketplace

.claude-plugin/marketplace.json

@@ -0,0 +1,27 @@
+{
+  "name": "visual-explainer-marketplace",
+  "owner": {
+    "name": "nicobailon"
+  },
+  "metadata": {
+    "description": "A marketplace for visual explainer plugins — tools that turn complex terminal output into styled HTML pages",
+    "version": "1.0.0",
+    "pluginRoot": "./plugins"
+  },
+  "plugins": [
+    {
+      "name": "visual-explainer",
+      "source": "./plugins/visual-explainer",
+      "description": "Generate beautiful HTML pages for diagrams, diff reviews, plan reviews, slides, and data tables",
+      "version": "0.5.0",
+      "author": {
+        "name": "nicobailon"
+      },
+      "repository": "https://github.com/nicobailon/visual-explainer",
+      "license": "MIT",
+      "keywords": ["diagrams", "html", "visualization", "diff-review", "slides"],
+      "category": "visualization",
+      "tags": ["diagrams", "html-generation", "code-review", "slides", "mermaid"]
+    }
+  ]
+}

.claude-plugin/plugin.json

@@ -1,10 +1,5 @@
 {
-  "name": "visual-explainer",
-  "description": "Generate beautiful HTML pages for diagrams, diff reviews, plan reviews, and data tables",
-  "version": "0.5.0",
-  "author": {
-    "name": "nicobailon"
-  },
-  "repository": "https://github.com/nicobailon/visual-explainer",
-  "license": "MIT"
+  "name": "visual-explainer-marketplace",
+  "description": "A marketplace for visual explainer plugins",
+  "version": "1.0.0"
 }

README.md

@@ -28,18 +28,24 @@ This skill fixes that. Real typography, dark/light themes, interactive Mermaid d
 
 ## Install
 
-**Pi:**
-```bash
-pi install https://github.com/nicobailon/visual-explainer
+**Claude Code (marketplace):**
+```shell
+/plugin marketplace add nicobailon/visual-explainer
+/plugin install visual-explainer@visual-explainer-marketplace
 ```
 
-**Claude Code (plugin):**
+**Claude Code (direct plugin):**
 ```bash
 claude /plugin install https://github.com/nicobailon/visual-explainer
 ```
 
 Note: Claude Code plugins namespace commands as `/visual-explainer:command-name`.
 
+**Pi:**
+```bash
+pi install https://github.com/nicobailon/visual-explainer
+```
+
 **OpenAI Codex:**
 ```bash
 git clone https://github.com/nicobailon/visual-explainer.git ~/.agents/skills/visual-explainer
@@ -76,19 +82,28 @@ https://github.com/user-attachments/assets/342d3558-5fcf-4fb2-bc03-f0dd5b9e35dc
 ## How It Works
 
 ```
-SKILL.md              ← workflow + design principles
-commands/             ← slash commands (works with pi and Claude Code)
-references/           ← agent reads before generating
-├── css-patterns.md   (layouts, animations, theming)
-├── libraries.md      (Mermaid, Chart.js, fonts)
-├── responsive-nav.md (sticky TOC for multi-section pages)
-└── slide-patterns.md (slide engine, transitions, presets)
-templates/            ← reference templates with different palettes
-├── architecture.html
-├── mermaid-flowchart.html
-├── data-table.html
-└── slide-deck.html
-    ↓
+.claude-plugin/
+├── plugin.json           ← marketplace identity
+└── marketplace.json      ← plugin catalog
+plugins/
+└── visual-explainer/
+    ├── .claude-plugin/
+    │   └── plugin.json   ← plugin manifest
+    ├── SKILL.md           ← workflow + design principles
+    ├── commands/          ← slash commands
+    ├── references/        ← agent reads before generating
+    │   ├── css-patterns.md   (layouts, animations, theming)
+    │   ├── libraries.md      (Mermaid, Chart.js, fonts)
+    │   ├── responsive-nav.md (sticky TOC for multi-section pages)
+    │   └── slide-patterns.md (slide engine, transitions, presets)
+    ├── templates/         ← reference templates with different palettes
+    │   ├── architecture.html
+    │   ├── mermaid-flowchart.html
+    │   ├── data-table.html
+    │   └── slide-deck.html
+    └── scripts/
+        └── share.sh
+            ↓
 ~/.agent/diagrams/filename.html → opens in browser
 ```
 

plugins/visual-explainer/.claude-plugin/plugin.json

@@ -0,0 +1,10 @@
+{
+  "name": "visual-explainer",
+  "description": "Generate beautiful HTML pages for diagrams, diff reviews, plan reviews, and data tables",
+  "version": "0.5.0",
+  "author": {
+    "name": "nicobailon"
+  },
+  "repository": "https://github.com/nicobailon/visual-explainer",
+  "license": "MIT"
+}