From 94610dbc6f26ecaefdbedcde063c3884b99a9512 Mon Sep 17 00:00:00 2001 From: Vincent Koc Date: Fri, 27 Feb 2026 09:17:10 -0800 Subject: [PATCH] docs(skills): show flat and two-layer capability declarations --- docs/tools/creating-skills.md | 22 +++++++++++++++++++++- 1 file changed, 21 insertions(+), 1 deletion(-) diff --git a/docs/tools/creating-skills.md b/docs/tools/creating-skills.md index f3882dcf25e..b10d824bdb5 100644 --- a/docs/tools/creating-skills.md +++ b/docs/tools/creating-skills.md @@ -47,7 +47,27 @@ metadata: { "openclaw": { "capabilities": ["shell", "filesystem"] } } --- ``` -Available capabilities: `shell`, `filesystem`, `network`, `browser`, `sessions`. +Available capabilities: `shell`, `filesystem`, `network`, `browser`, `sessions`, `messaging`, `scheduling`. + +You can use either a flat list or a 2-layer object shape under the same key: + +```markdown +--- +name: deploy_helper +description: Automate deployment workflows. +metadata: + { + "openclaw": + { + "capabilities": + { + "shell": { "mode": "restricted", "allow": ["git", "gh"] }, + "network": { "web_search": true, "web_fetch": true }, + }, + }, + } +--- +``` Skills without capabilities are treated as read-only (model-only instructions). Community skills published to ClawHub **must** declare capabilities matching their tool usage — undeclared capabilities are blocked at runtime.