From 83a5c1f0bc88fa12e65a8bb14752816ecb8785ab Mon Sep 17 00:00:00 2001
From: Vedang Manerikar <ved.manerikar@gmail.com>
Date: Fri, 6 Mar 2026 12:26:22 +0530
Subject: [PATCH 1/4] chore: add pi-package keyword

---
 package.json | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/package.json b/package.json
index de1aa5f..40f2e15 100644
--- a/package.json
+++ b/package.json
@@ -4,7 +4,8 @@
   "description": "Agent skill that generates beautiful HTML pages for diagrams, diff reviews, plan reviews, and data tables",
   "keywords": [
     "claude-code-plugin",
-    "agent-skill"
+    "agent-skill",
+    "pi-package"
   ],
   "license": "MIT"
 }

From b7809e1afd10be61bc02bbd5ec1c35c006c5f3c6 Mon Sep 17 00:00:00 2001
From: Vedang Manerikar <ved.manerikar@gmail.com>
Date: Fri, 6 Mar 2026 12:27:59 +0530
Subject: [PATCH 2/4] chore: add pi package manifest

---
 package.json | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/package.json b/package.json
index 40f2e15..eaf93fc 100644
--- a/package.json
+++ b/package.json
@@ -2,10 +2,10 @@
   "name": "visual-explainer",
   "version": "0.5.1",
   "description": "Agent skill that generates beautiful HTML pages for diagrams, diff reviews, plan reviews, and data tables",
-  "keywords": [
-    "claude-code-plugin",
-    "agent-skill",
-    "pi-package"
-  ],
-  "license": "MIT"
+  "keywords": ["claude-code-plugin", "agent-skill", "pi-package"],
+  "license": "MIT",
+  "pi": {
+    "skills": ["./plugins/visual-explainer"],
+    "prompts": ["./plugins/visual-explainer/commands"]
+  }
 }

From c22eb763f6f8918576fdf0fca340ef3847f38590 Mon Sep 17 00:00:00 2001
From: Vedang Manerikar <ved.manerikar@gmail.com>
Date: Fri, 6 Mar 2026 12:28:12 +0530
Subject: [PATCH 3/4] docs: update pi install instructions

---
 README.md | 18 +++++++-----------
 1 file changed, 7 insertions(+), 11 deletions(-)

diff --git a/README.md b/README.md
index c114945..92bc541 100644
--- a/README.md
+++ b/README.md
@@ -36,21 +36,17 @@ This skill fixes that. Real typography, dark/light themes, interactive Mermaid d
 
 Note: Claude Code plugins namespace commands as `/visual-explainer:command-name`.
 
-**Pi (manual):**
+**Pi:**
 ```bash
-# Clone the repo
-git clone --depth 1 https://github.com/nicobailon/visual-explainer.git /tmp/visual-explainer
-
-# Install skill
-cp -r /tmp/visual-explainer/plugins/visual-explainer ~/.pi/agent/skills/visual-explainer
+# Install globally
+pi install git:github.com/nicobailon/visual-explainer
 
-# Install prompt templates (slash commands)
-cp /tmp/visual-explainer/plugins/visual-explainer/commands/*.md ~/.pi/agent/prompts/
-
-# Cleanup
-rm -rf /tmp/visual-explainer
+# Or install for just the current project
+pi install -l git:github.com/nicobailon/visual-explainer
 ```
 
+This loads the `visual-explainer` skill plus the prompt templates (`/diff-review`, `/plan-review`, `/generate-web-diagram`, etc.) directly from the git repo.
+
 **OpenAI Codex:**
 ```bash
 git clone --depth 1 https://github.com/nicobailon/visual-explainer.git /tmp/visual-explainer

From cb58296cb0f85b2e00881556a1fe4b489d62513d Mon Sep 17 00:00:00 2001
From: Vedang Manerikar <ved.manerikar@gmail.com>
Date: Fri, 6 Mar 2026 12:28:16 +0530
Subject: [PATCH 4/4] docs: make share script paths pi-compatible

---
 plugins/visual-explainer/SKILL.md          | 4 ++--
 plugins/visual-explainer/commands/share.md | 4 +++-
 2 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/plugins/visual-explainer/SKILL.md b/plugins/visual-explainer/SKILL.md
index 6fa6acf..98225e7 100644
--- a/plugins/visual-explainer/SKILL.md
+++ b/plugins/visual-explainer/SKILL.md
@@ -363,12 +363,12 @@ Share visual explainer pages instantly via Vercel. No account or authentication
 
 **Usage:**
 ```bash
-bash {{skill_dir}}/scripts/share.sh <html-file>
+bash ./scripts/share.sh <html-file>
 ```
 
 **Example:**
 ```bash
-bash {{skill_dir}}/scripts/share.sh ~/.agent/diagrams/my-diagram.html
+bash ./scripts/share.sh ~/.agent/diagrams/my-diagram.html
 
 # Output:
 # ✓ Shared successfully!
diff --git a/plugins/visual-explainer/commands/share.md b/plugins/visual-explainer/commands/share.md
index 27533c5..5cf73c8 100644
--- a/plugins/visual-explainer/commands/share.md
+++ b/plugins/visual-explainer/commands/share.md
@@ -31,8 +31,10 @@ No Vercel account, Cloudflare account, or API keys needed. The deployment is "cl
 
 ## Script Location
 
+After loading the `visual-explainer` skill, run the script relative to the skill directory:
+
 ```bash
-bash {{skill_dir}}/scripts/share.sh <file>
+bash ./scripts/share.sh <file>
 ```
 
 ## Output