docs

Author: ericdallo

docs/config.json

@@ -89,17 +89,6 @@
         "additionalProperties": false
       }
     },
-    "enabledSkills": {
-      "type": "array",
-      "description": "List of regex patterns matching skill names to enable. Defaults to all skills enabled.",
-      "markdownDescription": "List of regex patterns matching skill names to enable. Defaults to all skills enabled.",
-      "items": {
-        "type": "string"
-      },
-      "default": [
-        ".*"
-      ]
-    },
     "disabledTools": {
       "type": "array",
       "description": "List of tool names to disable globally.",
@@ -539,14 +528,6 @@
             "type": "string"
           }
         },
-        "enabledSkills": {
-          "type": "array",
-          "description": "List of regex patterns matching skill names to enable for this agent.",
-          "markdownDescription": "List of regex patterns matching skill names to enable for this agent.",
-          "items": {
-            "type": "string"
-          }
-        },
         "autoCompactPercentage": {
           "type": "integer",
           "description": "Context window usage percentage at which auto-compact triggers for this agent.",

docs/config/introduction.md

@@ -152,7 +152,6 @@ By default ECA consider the following as the base configuration:
       "hooks": {},
       "rules" : [],
       "commands" : [],
-      "enabledSkills": [".*"],
       "disabledTools": [],
       "toolCall": {
         "approval": {

docs/config/tools.md

@@ -107,6 +107,36 @@ Placeholders in the format `{{argument_name}}` within the `command` string will
     }
     ```
 
+## Disabled tools
+
+You can completely disable tools so they are never available to the LLM. This is configured via the `disabledTools` config, which accepts a list of tool name strings.
+
+It can be set globally or per agent.
+
+=== "Global"
+
+    ```javascript title="~/.config/eca/config.json"
+    {
+      "disabledTools": ["eca__shell_command", "my-mcp__dangerous_tool"]
+    }
+    ```
+
+=== "Per agent"
+
+    ```javascript title="~/.config/eca/config.json"
+    {
+      "agent": {
+        "plan": {
+          "disabledTools": ["eca__edit_file", "eca__write_file", "eca__move_file"]
+        }
+      }
+    }
+    ```
+
+!!! tip "Disabled vs Denied"
+
+    `disabledTools` removes the tool entirely from the LLM — it won't even know it exists. This is different from `toolCall.approval.deny` which lets the LLM see the tool but blocks execution.
+
 ## Approval / permissions
 
 By default, ECA asks to call any non read-only tool (default [here](https://github.com/editor-code-assistant/eca/blob/5e598439e606727701a69393e55bbd205c9e16d8/src/eca/config.clj#L88-L96)), but that can easily be configured in several ways via the `toolCall.approval` config.