diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
index 139118e..6024ab2 100644
--- a/.claude-plugin/marketplace.json
+++ b/.claude-plugin/marketplace.json
@@ -6,7 +6,7 @@
   },
   "metadata": {
     "description": "Skills for developing and using Holistics BI platform to build analytics and get insights",
-    "version": "0.8.1"
+    "version": "0.8.3"
   },
   "plugins": [
     {
diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json
index 1662ef0..3ab1166 100644
--- a/.cursor-plugin/marketplace.json
+++ b/.cursor-plugin/marketplace.json
@@ -6,7 +6,7 @@
   },
   "metadata": {
     "description": "Skills for developing and using Holistics BI platform to build analytics and get insights",
-    "version": "0.7.1"
+    "version": "0.7.3"
   },
   "plugins": [
     {
diff --git a/plugins/holistics-common/skills/search-docs/SKILL.md b/plugins/holistics-common/skills/search-docs/SKILL.md
index 9b1fbdb..2e76354 100644
--- a/plugins/holistics-common/skills/search-docs/SKILL.md
+++ b/plugins/holistics-common/skills/search-docs/SKILL.md
@@ -17,6 +17,12 @@ description: Search Holistics documentation to answer questions about features,
 ## Tool: `search_docs`
 Use `search_docs` to look up Holistics knowledge. Do **NOT** use `search_docs` for how to use your tools — you are already provided with enough information for that.
 
+### Invocation
+Example payload:
+```json
+{"question": "how to define a relationship in a dataset?"}
+```
+
 ## Other references
 * See [](../../references/)
 * You can also check out https://docs.holistics.io when `search_docs` doesn't work well.
diff --git a/plugins/holistics-development/.claude-plugin/plugin.json b/plugins/holistics-development/.claude-plugin/plugin.json
index 4d30925..13daae6 100644
--- a/plugins/holistics-development/.claude-plugin/plugin.json
+++ b/plugins/holistics-development/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "name": "holistics-development",
   "description": "Skills for exploring, analyzing, and developing analytics code in Holistics Development environment.",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "author": {
     "name": "Holistics"
   },
diff --git a/plugins/holistics-development/.cursor-plugin/plugin.json b/plugins/holistics-development/.cursor-plugin/plugin.json
index fff4d30..e613324 100644
--- a/plugins/holistics-development/.cursor-plugin/plugin.json
+++ b/plugins/holistics-development/.cursor-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "name": "holistics-development",
   "description": "Skills for exploring, analyzing, and developing analytics code in Holistics Development environment.",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "author": {
     "name": "Holistics"
   },
diff --git a/plugins/holistics-development/CHANGELOG.md b/plugins/holistics-development/CHANGELOG.md
index a198be4..497ec97 100644
--- a/plugins/holistics-development/CHANGELOG.md
+++ b/plugins/holistics-development/CHANGELOG.md
@@ -1,3 +1,9 @@
+## [0.5.2](https://github.com-holistics/holistics/skills/compare/holistics-development-v0.5.1...holistics-development-v0.5.2) (2026-06-04)
+
+### Bug Fixes
+
+* **plugins.common,plugins.development,plugins.reporting:** document search_docs question param ([8350777](https://github.com-holistics/holistics/skills/commit/8350777b5275be0e6f0f09c8605a2d184b5396be))
+
 ## [0.5.1](https://github.com/holistics/skills/compare/holistics-development-v0.5.0...holistics-development-v0.5.1) (2026-06-01)
 
 ### Bug Fixes
diff --git a/plugins/holistics-development/skills/develop-amql/SKILL.md b/plugins/holistics-development/skills/develop-amql/SKILL.md
index 6eeb732..170cace 100644
--- a/plugins/holistics-development/skills/develop-amql/SKILL.md
+++ b/plugins/holistics-development/skills/develop-amql/SKILL.md
@@ -7,7 +7,7 @@ description: Write and edit AML/AQL code for Holistics models, datasets, dashboa
 * Use [](../setup-amql-development/) skill to prepare for the development
 * **NEVER** assume any AML/AQL syntax, functions, or references.
 * Use Holistics knowledge and tools
-  * Refer to [](../../references/) and use `search_docs` to learn about code syntax.
+  * Refer to [](../../references/) and use `search_docs` to learn about code syntax. See [](../search-docs/) for invocation details.
   * Use `fetch_dataset` to learn about the dataset (e.g. all available models and fields within that dataset), in order to make accurate edits.
   * Use `generate_aql` to write AQL (e.g. AQL metrics).
   * Use `generate_viz` to define Viz.
diff --git a/plugins/holistics-development/skills/search-docs/SKILL.md b/plugins/holistics-development/skills/search-docs/SKILL.md
index 9b1fbdb..2e76354 100644
--- a/plugins/holistics-development/skills/search-docs/SKILL.md
+++ b/plugins/holistics-development/skills/search-docs/SKILL.md
@@ -17,6 +17,12 @@ description: Search Holistics documentation to answer questions about features,
 ## Tool: `search_docs`
 Use `search_docs` to look up Holistics knowledge. Do **NOT** use `search_docs` for how to use your tools — you are already provided with enough information for that.
 
+### Invocation
+Example payload:
+```json
+{"question": "how to define a relationship in a dataset?"}
+```
+
 ## Other references
 * See [](../../references/)
 * You can also check out https://docs.holistics.io when `search_docs` doesn't work well.
diff --git a/plugins/holistics-development/skills/setup-amql-development/SKILL.md b/plugins/holistics-development/skills/setup-amql-development/SKILL.md
index 0544772..9fd3177 100644
--- a/plugins/holistics-development/skills/setup-amql-development/SKILL.md
+++ b/plugins/holistics-development/skills/setup-amql-development/SKILL.md
@@ -41,3 +41,10 @@ Use [](../setup-holistics-cli/) skill
   * `holistics mcp`: List available tools
   * `holistics mcp <tool> --help`: Learn more about a tool and its inputs, outputs
   * `holistics mcp <tool> '<json_payload>'`: Call a tool
+
+## Tool invocation discipline
+**Never guess `holistics mcp <tool>` parameter names.** A wrong key (e.g. `query` instead of `question` for `search_docs`) fails the entire call.
+
+Before the first call of any unfamiliar tool in a session:
+1. Run `holistics mcp <tool> --help` or native MCP to read its input schema.
+2. Construct the payload using exactly the documented property names.
diff --git a/plugins/holistics-reporting/.claude-plugin/plugin.json b/plugins/holistics-reporting/.claude-plugin/plugin.json
index 09512a3..8095d72 100644
--- a/plugins/holistics-reporting/.claude-plugin/plugin.json
+++ b/plugins/holistics-reporting/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "name": "holistics-reporting",
   "description": "Skills for exploring and analyzing data in Holistics using published analytics.",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "author": {
     "name": "Holistics"
   },
diff --git a/plugins/holistics-reporting/.cursor-plugin/plugin.json b/plugins/holistics-reporting/.cursor-plugin/plugin.json
index 4e9b1d5..9e9fe25 100644
--- a/plugins/holistics-reporting/.cursor-plugin/plugin.json
+++ b/plugins/holistics-reporting/.cursor-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "name": "holistics-reporting",
   "description": "Skills for exploring and analyzing data in Holistics using published analytics.",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "author": {
     "name": "Holistics"
   },
@@ -18,4 +18,4 @@
     "bi",
     "dashboards"
   ]
-}
\ No newline at end of file
+}
diff --git a/plugins/holistics-reporting/CHANGELOG.md b/plugins/holistics-reporting/CHANGELOG.md
index 57a1e3c..35bfcad 100644
--- a/plugins/holistics-reporting/CHANGELOG.md
+++ b/plugins/holistics-reporting/CHANGELOG.md
@@ -1,3 +1,9 @@
+## [0.1.1](https://github.com-holistics/holistics/skills/compare/holistics-reporting-v0.1.0...holistics-reporting-v0.1.1) (2026-06-04)
+
+### Bug Fixes
+
+* **plugins.common,plugins.development,plugins.reporting:** document search_docs question param ([8350777](https://github.com-holistics/holistics/skills/commit/8350777b5275be0e6f0f09c8605a2d184b5396be))
+
 ## [0.1.0](https://github.com/holistics/skills/compare/holistics-reporting-v0.0.4...holistics-reporting-v0.1.0) (2026-05-13)
 
 ### Features
diff --git a/plugins/holistics-reporting/skills/search-docs/SKILL.md b/plugins/holistics-reporting/skills/search-docs/SKILL.md
index 9b1fbdb..2e76354 100644
--- a/plugins/holistics-reporting/skills/search-docs/SKILL.md
+++ b/plugins/holistics-reporting/skills/search-docs/SKILL.md
@@ -17,6 +17,12 @@ description: Search Holistics documentation to answer questions about features,
 ## Tool: `search_docs`
 Use `search_docs` to look up Holistics knowledge. Do **NOT** use `search_docs` for how to use your tools — you are already provided with enough information for that.
 
+### Invocation
+Example payload:
+```json
+{"question": "how to define a relationship in a dataset?"}
+```
+
 ## Other references
 * See [](../../references/)
 * You can also check out https://docs.holistics.io when `search_docs` doesn't work well.