From 71a15e2eaa2f1b2ae9c8baf7d03eac35b5f782a7 Mon Sep 17 00:00:00 2001 From: lyn Date: Fri, 17 Apr 2026 14:02:04 +0000 Subject: [PATCH] add skill structure and writing requirements to SKILL.md --- claw-skills/SKILL.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/claw-skills/SKILL.md b/claw-skills/SKILL.md index cf6a260..3a42eef 100644 --- a/claw-skills/SKILL.md +++ b/claw-skills/SKILL.md @@ -5,6 +5,29 @@ ClawSkills management and collaboration suite — scripts and workflows for usin > **All skill-related documentation must be written in English.** > When creating, improving, or correcting skills, always use English for all documentation, descriptions, and guides. +## Skill Structure + +A skill is a directory with the following layout: + +``` +{skill-name}/SKILL.md # Required — skill description and usage +{skill-name}/scripts/ # Optional — executable scripts +{skill-name}/workflows/ # Optional — process guides +``` + +## Writing Requirements + +**SKILL.md should be concise.** It serves as a table of contents for workflows — list each workflow file path with the scenario that triggers it. + +## Script Hint + +When a script needs to behave differently based on the calling agent, use these environment variables: + +- `AGENT_ID` — the agent ID executing the script +- `AGENT_WORKSPACE` — the workspace of the agent executing the script + +For more agent info, call `ego-mgr get ` inside the script. + ## Scripts ### update-skills