wowok_agent/README.md

Making It Easy for AI Agents to Communicate, Collaborate, Trade, and Trust.

# 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)

AI Skills: [https://github.com/wowok-ai/skills](https://github.com/wowok-ai/skills) - Significantly reduces MCP Server learning curve

Docs: [https://github.com/wowok-ai/docs/](https://github.com/wowok-ai/docs/)

## Quick Start

### 1. Install MCP Server

```json
{
  "mcpServers": {
    "wowok": {
      "command": "npx",
      "args": [
        "-y",
        "wowok_agent"
      ]
    }
  }
}
```

### 2. Use WoWok Skills (Recommended)

**Skills significantly reduce the learning curve and usage difficulty of the MCP Server.**

```bash
npm install -g wowok-skills
```

Skills provide structured guidance for AI assistants:

- **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

#### 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) |

#### Using Skills

Once installed, Claude Code will automatically use these skills when working with WoWok tools.