docs: expand SKILL.md with comprehensive agent guidance

- Add MAX subscription warning
- Add full setup instructions
- Add routing modes table
- Add supported providers
- Add architecture diagram
- Add REST endpoints
- Add configuration examples
- Add troubleshooting section

Author: root

skill/SKILL.md

@@ -1,24 +1,29 @@
 ---
 name: relayplane
-description: RelayPlane proxy control - stats, status, and routing mode management
+description: RelayPlane proxy - intelligent LLM routing that cuts costs 50-80%. Stats, status, and routing mode management.
 user-invocable: true
-homepage: https://relayplane.com
-version: 1.2.0
-author: Continuum
+homepage: https://relayplane.com/integrations/openclaw
+version: 1.0.0
+author: RelayPlane
 license: MIT
 metadata: { "openclaw": { "emoji": "🚀", "category": "ai-tools", "requires": { "bins": ["node", "curl"] } } }
 ---
 
-# RelayPlane
+# RelayPlane Proxy
 
 **100% Local. Zero Cloud. Full Control.**
 
-Intelligent LLM gateway that routes requests to optimal models.
+Intelligent AI model routing that cuts costs by 50-80% while maintaining quality.
 
-> ⚠️ **Cost Monitoring Required**
+> **⚠️ IMPORTANT: API Key Users Only**
+> 
+> This is for standard API key users (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`).
+> **MAX subscription users should NOT use this** — MAX already gives unlimited usage, the proxy would just add complexity.
+
+> **⚠️ Cost Monitoring Required**
 >
 > RelayPlane routes requests to LLM providers using your API keys. **This incurs real costs.**
-> Monitor usage through your provider's dashboard and use `/relayplane stats` to track requests.
+> Set up billing alerts with your providers and use `/relayplane stats` to track usage.
 
 ## Slash Commands
 
@@ -29,52 +34,125 @@ Intelligent LLM gateway that routes requests to optimal models.
 | `/relayplane switch <mode>` | Change routing mode (auto\|cost\|fast\|quality) |
 | `/relayplane models` | List available routing models |
 
-## Usage
+## Quick Start (Help Users Set This Up)
 
-When user invokes `/relayplane <subcommand>`, run:
+### 1. Set API keys
+```bash
+export ANTHROPIC_API_KEY="sk-ant-..."
+export OPENAI_API_KEY="sk-..."  # Optional
+```
+
+### 2. Start the proxy
+```bash
+npx @relayplane/proxy --port 3001
+```
 
+### 3. Point tools to proxy
 ```bash
-node {baseDir}/relayplane.js <subcommand>
+export ANTHROPIC_BASE_URL=http://localhost:3001
+export OPENAI_BASE_URL=http://localhost:3001
+openclaw  # or any tool
 ```
 
-Examples:
-- `/relayplane stats` → `node {baseDir}/relayplane.js stats`
-- `/relayplane status` → `node {baseDir}/relayplane.js status`
-- `/relayplane switch cost` → `node {baseDir}/relayplane.js switch cost`
+## Routing Modes
+
+| Mode | Model Name | Description |
+|------|------------|-------------|
+| Auto | `relayplane:auto` | Smart routing - infers task, picks optimal model |
+| Cost | `relayplane:cost` | Always cheapest (Haiku) - maximum savings |
+| Fast | `relayplane:fast` | Lowest latency models |
+| Quality | `relayplane:quality` | Always best model (Opus) |
+
+## Supported Providers
+
+- **Anthropic:** Claude 3.5 Haiku, Sonnet 4, Opus 4.5
+- **OpenAI:** GPT-4o, GPT-4o-mini, o1, o3
+- **Google:** Gemini 2.0 Flash, Gemini Pro
+- **xAI:** Grok models
+- **Moonshot:** v1 (8k, 32k, 128k)
+
+## How It Works
 
-## REST Endpoints (Alternative)
+```
+User's Tool (OpenClaw, Cursor, etc.)
+         │
+         ▼
+    RelayPlane Proxy (localhost:3001)
+    ├── Infers task type (code_review, analysis, etc.)
+    ├── Routes to optimal model (Haiku for simple, Opus for complex)
+    ├── Tracks outcomes for learning
+    └── Streams response back
+         │
+         ▼
+    Provider API (Anthropic, OpenAI, etc.)
+```
 
-If the script isn't available, use curl:
+## REST Endpoints (For Script/Curl Access)
 
 ```bash
-# Stats
-curl -s http://127.0.0.1:3001/control/stats
+# Check status
+curl http://localhost:3001/control/status
+
+# Get stats
+curl http://localhost:3001/control/stats
+
+# Enable/disable routing
+curl -X POST http://localhost:3001/control/enable
+curl -X POST http://localhost:3001/control/disable
 
-# Status
-curl -s http://127.0.0.1:3001/control/status
+# Update config
+curl -X POST http://localhost:3001/control/config \
+  -H "Content-Type: application/json" \
+  -d '{"routing": {"mode": "cascade"}}'
 ```
 
-## Quick Start
+## Configuration
+
+Config file: `~/.relayplane/config.json` (hot-reloads on save)
+
+```json
+{
+  "enabled": true,
+  "routing": {
+    "mode": "cascade",
+    "cascade": {
+      "models": ["claude-3-haiku-20240307", "claude-3-5-sonnet-20241022", "claude-3-opus-20240229"],
+      "escalateOn": "uncertainty",
+      "maxEscalations": 1
+    },
+    "complexity": {
+      "simple": "claude-3-haiku-20240307",
+      "moderate": "claude-3-5-sonnet-20241022",
+      "complex": "claude-3-opus-20240229"
+    }
+  }
+}
+```
+
+## Data Storage
+
+All data local: `~/.relayplane/data.db` (SQLite)
 
 ```bash
-# Set API keys
-export ANTHROPIC_API_KEY="sk-ant-..."
-export ANTHROPIC_BASE_URL=http://localhost:3001
+# Query routing history
+sqlite3 ~/.relayplane/data.db "SELECT model, task_type, COUNT(*) FROM runs GROUP BY model, task_type"
+```
 
-# Start proxy
-npx @relayplane/proxy --port 3001
+## Troubleshooting
+
+**Proxy not running?**
+```bash
+npx @relayplane/proxy --port 3001 -v
 ```
 
-## Routing Modes
+**Wrong model being used?**
+Check `ANTHROPIC_BASE_URL` is set to `http://localhost:3001`
 
-| Mode | Description |
-|------|-------------|
-| `auto` | Cascade routing - starts cheap, escalates on uncertainty |
-| `cost` | Always use cheapest model |
-| `fast` | Prioritize lowest latency |
-| `quality` | Always use best model |
+**Want to bypass proxy temporarily?**
+Unset the BASE_URL or use `X-RelayPlane-Bypass: true` header
 
-## More Info
+## Links
 
 - [GitHub](https://github.com/RelayPlane/proxy)
-- [Documentation](https://relayplane.com/docs)
+- [Documentation](https://relayplane.com/integrations/openclaw)
+- [npm](https://www.npmjs.com/package/@relayplane/proxy)