add skill structure and writing requirements to SKILL.md

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 <column>` inside the script.
+
 ## Scripts
 
 ### update-skills