diff --git a/extensions/llm-task/clawdbot.plugin.json b/extensions/llm-task/clawdbot.plugin.json
index 7f957ea79..08f8cc067 100644
--- a/extensions/llm-task/clawdbot.plugin.json
+++ b/extensions/llm-task/clawdbot.plugin.json
@@ -1,3 +1,21 @@
 {
-  id: llm-task,
-  name: LLM
+  "id": "llm-task",
+  "name": "LLM Task",
+  "description": "Generic JSON-only LLM tool for structured tasks callable from workflows.",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "defaultProvider": { "type": "string" },
+      "defaultModel": { "type": "string" },
+      "defaultAuthProfileId": { "type": "string" },
+      "allowedModels": {
+        "type": "array",
+        "items": { "type": "string" },
+        "description": "Allowlist of provider/model keys like openai-codex/gpt-5.2."
+      },
+      "maxTokens": { "type": "number" },
+      "timeoutMs": { "type": "number" }
+    }
+  }
+}