add workflows: fix-skills, improve-skills, create-skills

claw-skills/SKILL.md

@@ -1,3 +1,46 @@
 # claw-skills
 
-_placeholder skill_
+ClawSkills 管理和协作套件，提供 scripts 和 workflows 来规范 skill 的使用和改进流程。
+
+## Scripts
+
+### update-skills
+
+Pull latest ClawSkills from git-hangman-lab, then run learn.sh to install/update skills to `{AGENT_WORKSPACE}/skills`.
+
+```bash
+claw-skills/scripts/update-skills
+```
+
+### promote-improvements
+
+Create and force-push a branch named after the agent (via `ego-mgr get name`) from `{AGENT_WORKSPACE}`.
+
+```bash
+claw-skills/scripts/promote-improvements
+```
+
+## Workflows
+
+### fix-skills
+
+如果使用某个 skill 或其脚本没有达到预期效果，或脚本报错：
+
+> **不要轻易使用 workaround。**
+> 参考 `{baseDir}/workflows/fix-skills.md`，按该流程定位根因并修复。
+
+### improve-skills
+
+如果使用 skill 的过程中发现现有 skill 或 workflow 存在以下问题：
+
+- 有误导或歧义
+- 没有覆盖到你的使用情景
+- 效果不理想
+
+> 参考 `{baseDir}/workflows/improve-skills.md` 进行改进。
+
+### create-skills
+
+如果工作过程中发现某些模式或流程可以显著提高效率，但目前没有 skill 覆盖：
+
+> 参考 `{baseDir}/workflows/create-skills.md` 创建新的 skill。