重构主控编排与运行时预热链路，统一工作区提示词/专家调度协议并补齐 wiki 记忆注入与写回闭环。

同时收敛启动与运维脚本默认行为（含 wiki worker）、更新 Admin 可观测性与相关测试，降低首轮时延并提高运行稳定性。

Made-with: Cursor

openclaw/docs/tools/creating-skills.md

@@ -0,0 +1,119 @@
+---
+title: "Creating Skills"
+summary: "Build and test custom workspace skills with SKILL.md"
+read_when:
+  - You are creating a new custom skill in your workspace
+  - You need a quick starter workflow for SKILL.md-based skills
+---
+
+# Creating Skills
+
+Skills teach the agent how and when to use tools. Each skill is a directory
+containing a `SKILL.md` file with YAML frontmatter and markdown instructions.
+
+For how skills are loaded and prioritized, see [Skills](/tools/skills).
+
+## Create your first skill
+
+<Steps>
+  <Step title="Create the skill directory">
+    Skills live in your workspace. Create a new folder:
+
+    ```bash
+    mkdir -p ~/.openclaw/workspace/skills/hello-world
+    ```
+
+  </Step>
+
+  <Step title="Write SKILL.md">
+    Create `SKILL.md` inside that directory. The frontmatter defines metadata,
+    and the markdown body contains instructions for the agent.
+
+    ```markdown
+    ---
+    name: hello_world
+    description: A simple skill that says hello.
+    ---
+
+    # Hello World Skill
+
+    When the user asks for a greeting, use the `echo` tool to say
+    "Hello from your custom skill!".
+    ```
+
+  </Step>
+
+  <Step title="Add tools (optional)">
+    You can define custom tool schemas in the frontmatter or instruct the agent
+    to use existing system tools (like `exec` or `browser`). Skills can also
+    ship inside plugins alongside the tools they document.
+
+  </Step>
+
+  <Step title="Load the skill">
+    Start a new session so OpenClaw picks up the skill:
+
+    ```bash
+    # From chat
+    /new
+
+    # Or restart the gateway
+    openclaw gateway restart
+    ```
+
+    Verify the skill loaded:
+
+    ```bash
+    openclaw skills list
+    ```
+
+  </Step>
+
+  <Step title="Test it">
+    Send a message that should trigger the skill:
+
+    ```bash
+    openclaw agent --message "give me a greeting"
+    ```
+
+    Or just chat with the agent and ask for a greeting.
+
+  </Step>
+</Steps>
+
+## Skill metadata reference
+
+The YAML frontmatter supports these fields:
+
+| Field                               | Required | Description                                 |
+| ----------------------------------- | -------- | ------------------------------------------- |
+| `name`                              | Yes      | Unique identifier (snake_case)              |
+| `description`                       | Yes      | One-line description shown to the agent     |
+| `metadata.openclaw.os`              | No       | OS filter (`["darwin"]`, `["linux"]`, etc.) |
+| `metadata.openclaw.requires.bins`   | No       | Required binaries on PATH                   |
+| `metadata.openclaw.requires.config` | No       | Required config keys                        |
+
+## Best practices
+
+- **Be concise** — instruct the model on _what_ to do, not how to be an AI
+- **Safety first** — if your skill uses `exec`, ensure prompts don't allow arbitrary command injection from untrusted input
+- **Test locally** — use `openclaw agent --message "..."` to test before sharing
+- **Use ClawHub** — browse and contribute skills at [ClawHub](https://clawhub.ai)
+
+## Where skills live
+
+| Location                        | Precedence | Scope                 |
+| ------------------------------- | ---------- | --------------------- |
+| `\<workspace\>/skills/`         | Highest    | Per-agent             |
+| `\<workspace\>/.agents/skills/` | High       | Per-workspace agent   |
+| `~/.agents/skills/`             | Medium     | Shared agent profile  |
+| `~/.openclaw/skills/`           | Medium     | Shared (all agents)   |
+| Bundled (shipped with OpenClaw) | Low        | Global                |
+| `skills.load.extraDirs`         | Lowest     | Custom shared folders |
+
+## Related
+
+- [Skills reference](/tools/skills) — loading, precedence, and gating rules
+- [Skills config](/tools/skills-config) — `skills.*` config schema
+- [ClawHub](/tools/clawhub) — public skill registry
+- [Building Plugins](/plugins/building-plugins) — plugins can ship skills