wowok_agent 2.2.4 → 2.2.6

package/README.md

@@ -1,9 +1,14 @@
 # WoWok Agent (MCP Server)
 Making It Easy for AI Agents to Communicate, Collaborate, Trade, and Trust.
 
+GitHub: [https://github.com/wowok-ai/agent](https://github.com/wowok-ai/agent)
+
 Docs: [https://github.com/wowok-ai/docs/](https://github.com/wowok-ai/docs/)   
 
-## Setup   
+## Quick Start
+
+### 1. Install MCP Server
+
 ```json
 {
   "mcpServers": {
@@ -18,3 +23,108 @@ Docs: [https://github.com/wowok-ai/docs/](https://github.com/wowok-ai/docs/)
 }
 ```
 
+### 2. Use Claude Skills (Optional but Recommended)
+
+This repository includes **Claude Skills** that help AI assistants use WoWok tools correctly. Skills solve common AI challenges:
+
+- **Complex system building** — Dependency chains, build order, step-by-step patterns
+- **Tool usage failures** — Correct parameter formats, tool selection, error recovery
+- **Safety & authorization** — User confirmation for important operations
+
+#### Setup Skills
+
+This repository includes a pre-configured `.claude/settings.json` that references the `skills/` directory. You have three options:
+
+**Option A: Use skills directly in this repo (Recommended for development)**
+
+The repository already contains `.claude/settings.json` configured to use `skills/`:
+
+```bash
+git clone https://github.com/wowok-ai/mcp.git
+cd mcp
+# Claude Code will automatically detect and use the skills
+```
+
+**Option B: Copy skills to your own project**
+
+If you want to customize or own the skills in your project:
+
+```bash
+# From your project directory
+mkdir -p .claude/skills
+cp -r /path/to/mcp/skills/* .claude/skills/
+
+# Or clone and copy
+git clone https://github.com/wowok-ai/mcp.git /tmp/wowok-mcp
+cp -r /tmp/wowok-mcp/skills/* .claude/skills/
+```
+
+Then create `.claude/settings.json` in your project:
+
+```json
+{
+  "skills": {
+    "directories": [
+      "./skills"
+    ]
+  }
+}
+```
+
+**Option C: Reference skills from mcp repo (Recommended for production)**
+
+Keep skills in the mcp repo and reference them from your project:
+
+```json
+// .claude/settings.json in YOUR project
+{
+  "skills": {
+    "directories": [
+      "/path/to/mcp/skills"
+    ]
+  }
+}
+```
+
+This way you get updates when the mcp repo is updated.
+
+#### Migrating Skills to Your Project
+
+To fully migrate skills to your own project (for customization):
+
+```bash
+# 1. Copy all skills
+mkdir -p .claude/skills
+cp -r /path/to/mcp/skills/* .claude/skills/
+
+# 2. Create settings.json
+cat > .claude/settings.json << 'EOF'
+{
+  "skills": {
+    "directories": [
+      "./skills"
+    ]
+  }
+}
+EOF
+
+# 3. Verify structure
+ls -la .claude/skills/
+# Should show: wowok-build, wowok-guard, wowok-tools, etc.
+```
+
+Now you can modify the skills in `.claude/skills/` to suit your needs.
+
+#### Available Skills
+
+| Skill | Purpose |
+|-------|---------|
+| `wowok-build` | Complex system building (Service + Machine + Guard + Allocation + Reward) |
+| `wowok-guard` | Guard design mastery (programmable trust rules) |
+| `wowok-tools` | MCP tool usage mastery (13 tools, common pitfalls) |
+| `wowok-safety` | Safety & authorization protocol (dry-run → confirm → execute) |
+| `wowok-machine` | Machine workflow design (state machines, progress tracking) |
+| `wowok-order` | Order lifecycle management (payment, allocation, arbitration) |
+
+## Development
+