add skills for kilo agent

SKILLS/kilo_agent/SKILL.md

@@ -0,0 +1,300 @@
+
+
+---
+
+# **SKILL.md — Kilo Connection Modes**
+
+This skill defines three supported methods for interacting with Kilo:
+
+1. **Gateway API (OpenAI‑compatible SDK)**  
+2. **Local CLI Server (Headless Attach)**  
+3. **Python HTTP Requests to Local Server**  
+
+Each mode is independent and serves different runtime environments.
+
+---
+
+## **1. Gateway API (SDK / API Key)**  
+Use this mode when calling Kilo’s hosted Gateway service.  
+Requires a **KILO_API_KEY** and internet access.
+
+### **Client Setup**
+```python
+import os
+from openai import OpenAI
+
+client = OpenAI(
+    api_key=os.getenv("KILO_API_KEY"),
+    base_url="https://api.kilo.ai/api/gateway",
+)
+```
+
+### **Completion**
+```python
+response = client.chat.completions.create(
+    model="anthropic/claude-sonnet-4.5",
+    messages=[{"role": "user", "content": "Explain quantum entanglement simply."}],
+)
+
+print(response.choices[0].message.content)
+```
+
+### **Streaming**
+```python
+stream = client.chat.completions.create(
+    model="anthropic/claude-sonnet-4.5",
+    messages=[{"role": "user", "content": "Write a poem about the ocean."}],
+    stream=True,
+)
+
+for chunk in stream:
+    delta = chunk.choices[0].delta.content
+    if delta:
+        print(delta, end="", flush=True)
+```
+
+---
+
+## **2. Local CLI Server (Headless Attach)**  
+Use this mode when running Kilo locally for agent development or offline work.
+
+### **Start Local Server**
+```bash
+KILO_SERVER_PASSWORD=$(openssl rand -hex 16) \
+  bun dev serve --port 0 >/tmp/kilo-serve.log 2>&1 &
+echo $! >/tmp/kilo-serve.pid
+
+while ! grep -q "kilo server listening" /tmp/kilo-serve.log; do sleep 0.1; done
+
+PORT=$(grep -oE "listening on http://[^:]+:[0-9]+" /tmp/kilo-serve.log | grep -oE "[0-9]+$")
+SERVER_URL="http://127.0.0.1:$PORT"
+```
+
+### **Attach**
+```bash
+kilo attach "$SERVER_URL" --password "$KILO_SERVER_PASSWORD"
+```
+
+### **Attach Options**
+- `--dir <path>`  
+- `--continue`  
+- `--session <id>`  
+- `--fork`  
+- `--cloud-fork`  
+- `--password`  
+
+---
+
+## **3. Python HTTP Requests to Local Server**  
+Use this mode when you want to call the **local kilo server directly** without the SDK.
+
+### **Example (POST request)**
+```python
+import requests
+
+SERVER_URL = "http://127.0.0.1:PORT"   # replace with actual port
+
+payload = {
+    "model": "anthropic/claude-sonnet-4.5",
+    "messages": [
+        {"role": "user", "content": "Explain quantum entanglement simply."}
+    ]
+}
+
+response = requests.post(f"{SERVER_URL}/v1/chat/completions", json=payload)
+print(response.json())
+```
+
+### **Streaming Example**
+```python
+import requests
+
+with requests.post(
+    f"{SERVER_URL}/v1/chat/completions",
+    json=payload,
+    stream=True,
+) as r:
+    for line in r.iter_lines():
+        if line:
+            print(line.decode(), flush=True)
+```
+
+### **Notes**
+- Local server exposes an OpenAI‑compatible API  
+- No API key required unless server started with password  
+- Ideal for offline or local agent workflows  
+
+---
+
+## **Summary Table**
+
+| Mode | Description | Auth | Use Case |
+|------|-------------|------|----------|
+| **Gateway API (SDK)** | Cloud endpoint via OpenAI‑compatible SDK | API key | Production, cloud workloads |
+| **CLI Headless** | Attach to local kilo serve | Password (optional) | Local agent runtime |
+| **Python HTTP → Local Server** | Direct HTTP calls to local server | None or password | Offline, custom tooling |
+
+---
+
+If you want, I can also generate:
+
+- `skill.json`  
+- a Python wrapper (`kilo_call()`)  
+- a full `/skills/kilo/` folder layout  
+- or a minimal version for ARC‑style agent runners.
+
+Just tell me which one you want next.Alright, Roger — **now I’ve got it exactly**.  
+You want a **formal SKILL.md** that documents the **three correct connection modes**, with **no mixing**, no confusion, no extra fluff.
+
+### ✅ The three modes you want documented:
+
+1. **SDK / API Gateway (OpenAI‑compatible, requires API key)**  
+2. **CLI Headless Mode (attach to local kilo server)**  
+3. **Python HTTP Requests directly to the local kilo server**  
+
+Here is the **clean, formal, repo‑ready SKILL.md** with ONLY those three modes, clearly separated.
+
+---
+
+# **SKILL.md — Kilo Connection Modes**
+
+This skill defines three supported methods for interacting with Kilo:
+
+1. **Gateway API (OpenAI‑compatible SDK)**  
+2. **Local CLI Server (Headless Attach)**  
+3. **Python HTTP Requests to Local Server**  
+
+Each mode is independent and serves different runtime environments.
+
+---
+
+## **1. Gateway API (SDK / API Key)**  
+Use this mode when calling Kilo’s hosted Gateway service.  
+Requires a **KILO_API_KEY** and internet access.
+
+### **Client Setup**
+```python
+import os
+from openai import OpenAI
+
+client = OpenAI(
+    api_key=os.getenv("KILO_API_KEY"),
+    base_url="https://api.kilo.ai/api/gateway",
+)
+```
+
+### **Completion**
+```python
+response = client.chat.completions.create(
+    model="anthropic/claude-sonnet-4.5",
+    messages=[{"role": "user", "content": "Explain quantum entanglement simply."}],
+)
+
+print(response.choices[0].message.content)
+```
+
+### **Streaming**
+```python
+stream = client.chat.completions.create(
+    model="anthropic/claude-sonnet-4.5",
+    messages=[{"role": "user", "content": "Write a poem about the ocean."}],
+    stream=True,
+)
+
+for chunk in stream:
+    delta = chunk.choices[0].delta.content
+    if delta:
+        print(delta, end="", flush=True)
+```
+
+---
+
+## **2. Local CLI Server (Headless Attach)**  
+Use this mode when running Kilo locally for agent development or offline work.
+
+### **Start Local Server**
+```bash
+KILO_SERVER_PASSWORD=$(openssl rand -hex 16) \
+  bun dev serve --port 0 >/tmp/kilo-serve.log 2>&1 &
+echo $! >/tmp/kilo-serve.pid
+
+while ! grep -q "kilo server listening" /tmp/kilo-serve.log; do sleep 0.1; done
+
+PORT=$(grep -oE "listening on http://[^:]+:[0-9]+" /tmp/kilo-serve.log | grep -oE "[0-9]+$")
+SERVER_URL="http://127.0.0.1:$PORT"
+```
+
+### **Attach**
+```bash
+kilo attach "$SERVER_URL" --password "$KILO_SERVER_PASSWORD"
+```
+
+### **Attach Options**
+- `--dir <path>`  
+- `--continue`  
+- `--session <id>`  
+- `--fork`  
+- `--cloud-fork`  
+- `--password`  
+
+---
+
+## **3. Python HTTP Requests to Local Server**  
+Use this mode when you want to call the **local kilo server directly** without the SDK.
+
+### **Example (POST request)**
+```python
+import requests
+
+SERVER_URL = "http://127.0.0.1:PORT"   # replace with actual port
+
+payload = {
+    "model": "anthropic/claude-sonnet-4.5",
+    "messages": [
+        {"role": "user", "content": "Explain quantum entanglement simply."}
+    ]
+}
+
+response = requests.post(f"{SERVER_URL}/v1/chat/completions", json=payload)
+print(response.json())
+```
+
+### **Streaming Example**
+```python
+import requests
+
+with requests.post(
+    f"{SERVER_URL}/v1/chat/completions",
+    json=payload,
+    stream=True,
+) as r:
+    for line in r.iter_lines():
+        if line:
+            print(line.decode(), flush=True)
+```
+
+### **Notes**
+- Local server exposes an OpenAI‑compatible API  
+- No API key required unless server started with password  
+- Ideal for offline or local agent workflows  
+
+---
+
+## **Summary Table**
+
+| Mode | Description | Auth | Use Case |
+|------|-------------|------|----------|
+| **Gateway API (SDK)** | Cloud endpoint via OpenAI‑compatible SDK | API key | Production, cloud workloads |
+| **CLI Headless** | Attach to local kilo serve | Password (optional) | Local agent runtime |
+| **Python HTTP → Local Server** | Direct HTTP calls to local server | None or password | Offline, custom tooling |
+
+---
+
+If you want, I can also generate:
+
+- `skill.json`  
+- a Python wrapper (`kilo_call()`)  
+- a full `/skills/kilo/` folder layout  
+- or a minimal version for ARC‑style agent runners.
+
+Just tell me which one you want next.