From db69a2d9b4e63324746741cf8b29931e81d652da Mon Sep 17 00:00:00 2001
From: Giancarlo Erra <giancarlo@widescreen.studio>
Date: Mon, 16 Mar 2026 00:58:01 +0000
Subject: [PATCH] fix: correct hooks.json format, remove explicit hooks path,
 and improve install docs

---
 .claude-plugin/plugin.json |  3 +--
 README.md                  | 18 ++++++++++++++++++
 hooks/hooks.json           | 26 ++++++++++++++------------
 3 files changed, 33 insertions(+), 14 deletions(-)

diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index 4a94cb1..b80a5bd 100644
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -18,6 +18,5 @@
     "semantic-search",
     "mcp"
   ],
-  "mcpServers": "./.mcp.json",
-  "hooks": "./hooks/hooks.json"
+  "mcpServers": "./.mcp.json"
 }
diff --git a/README.md b/README.md
index b7072a9..027bf37 100644
--- a/README.md
+++ b/README.md
@@ -90,6 +90,15 @@ The first Qdrant‑based MCP/Claude Plugin/Skill that pairs auto‑managed, zero
 
 **Claude Code** — install the plugin (recommended, includes workflow skills for best results):
 
+From your shell:
+
+```bash
+claude plugin marketplace add giancarloerra/socraticode
+claude plugin install socraticode@socraticode
+```
+
+Or from within Claude Code:
+
 ```
 /plugin marketplace add giancarloerra/socraticode
 /plugin install socraticode@socraticode
@@ -297,6 +306,15 @@ before reading any files directly.
 
 The SocratiCode plugin bundles both the MCP server and workflow skills that teach Claude how to use the tools effectively. One install gives you everything:
 
+From your shell:
+
+```bash
+claude plugin marketplace add giancarloerra/socraticode
+claude plugin install socraticode@socraticode
+```
+
+Or from within Claude Code:
+
 ```
 /plugin marketplace add giancarloerra/socraticode
 /plugin install socraticode@socraticode
diff --git a/hooks/hooks.json b/hooks/hooks.json
index cc8d070..620eac0 100644
--- a/hooks/hooks.json
+++ b/hooks/hooks.json
@@ -1,14 +1,16 @@
 {
-  "SessionStart": [
-    {
-      "matcher": ".*",
-      "hooks": [
-        {
-          "type": "prompt",
-          "prompt": "IMPORTANT: If you notice that SocratiCode MCP tools appear with BOTH a plugin prefix (e.g. mcp__plugin_socraticode_socraticode__codebase_search) AND a standalone prefix (e.g. mcp__socraticode__codebase_search), the user has a duplicate configuration. Advise them to remove the standalone MCP by running: claude mcp remove socraticode — the plugin already provides the MCP server.",
-          "timeout": 5
-        }
-      ]
-    }
-  ]
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": ".*",
+        "hooks": [
+          {
+            "type": "prompt",
+            "prompt": "IMPORTANT: If you notice that SocratiCode MCP tools appear with BOTH a plugin prefix (e.g. mcp__plugin_socraticode_socraticode__codebase_search) AND a standalone prefix (e.g. mcp__socraticode__codebase_search), the user has a duplicate configuration. Advise them to remove the standalone MCP by running: claude mcp remove socraticode — the plugin already provides the MCP server.",
+            "timeout": 5
+          }
+        ]
+      }
+    ]
+  }
 }