docs: add auto_start param, expand skill development guide

- Add auto_start boolean to YOLO 2026 config.yaml
- Expand skill-development.md: config.yaml schema format, deploy.sh,
  environment variables, skills.json registration, status values

Author: solderzzc

docs/skill-development.md

@@ -11,7 +11,13 @@ A skill is a self-contained folder that provides an AI capability to [SharpAI Ae
 ```
 skills/<category>/<skill-name>/
 ├── SKILL.md              # Manifest + setup instructions
-├── requirements.txt      # Python dependencies
+├── config.yaml           # Configuration schema for Aegis UI
+├── deploy.sh             # Zero-assumption installer
+├── requirements.txt      # Default Python dependencies
+├── requirements_cuda.txt # NVIDIA GPU dependencies
+├── requirements_rocm.txt # AMD GPU dependencies
+├── requirements_mps.txt  # Apple Silicon dependencies
+├── requirements_cpu.txt  # CPU-only dependencies
 ├── scripts/
 │   └── main.py           # Entry point
 ├── assets/
@@ -68,6 +74,70 @@ LLM agent can read and execute.
 | `url` | URL input with validation | Server address |
 | `camera_select` | Camera picker | Target cameras |
 
+## config.yaml — Configuration Schema
+
+Defines user-configurable options shown in the Aegis Skills UI. Parsed by `parseConfigYaml()`.
+
+```yaml
+params:
+  - key: auto_start
+    label: Auto Start
+    type: boolean
+    default: false
+    description: "Start automatically on Aegis launch"
+
+  - key: model_size
+    label: Model Size
+    type: select
+    default: nano
+    description: "Choose model variant"
+    options:
+      - { value: nano, label: "Nano (fastest)" }
+      - { value: small, label: "Small (balanced)" }
+
+  - key: confidence
+    label: Confidence
+    type: number
+    default: 0.5
+    description: "Min confidence (0.1–1.0)"
+```
+
+### Reserved Keys
+
+| Key | Type | Behavior |
+|-----|------|----------|
+| `auto_start` | boolean | Aegis auto-starts the skill on boot when `true` |
+
+## deploy.sh — Zero-Assumption Installer
+
+Bootstraps the environment from scratch. Must handle:
+
+1. **Find Python** — check system → conda → pyenv
+2. **Create venv** — isolated `.venv/` inside skill directory
+3. **Detect GPU** — CUDA → ROCm → MPS → CPU fallback
+4. **Install deps** — from matching `requirements_<backend>.txt`
+5. **Verify** — import test
+
+Emit JSONL progress for Aegis UI:
+```bash
+echo '{"event": "progress", "stage": "gpu", "backend": "mps"}'
+echo '{"event": "complete", "backend": "mps", "message": "Installed!"}'
+```
+
+## Environment Variables
+
+Aegis injects these into every skill process:
+
+| Variable | Description |
+|----------|-------------|
+| `AEGIS_SKILL_ID` | Skill identifier |
+| `AEGIS_SKILL_PARAMS` | JSON string of user config values |
+| `AEGIS_GATEWAY_URL` | LLM gateway URL |
+| `AEGIS_VLM_URL` | VLM server URL |
+| `AEGIS_LLM_MODEL` | Active LLM model name |
+| `AEGIS_VLM_MODEL` | Active VLM model name |
+| `PYTHONUNBUFFERED` | Set to `1` for real-time output |
+
 ## JSON Lines Protocol
 
 Scripts communicate with Aegis via stdin/stdout. Each line is a JSON object.
@@ -108,6 +178,36 @@ Scripts communicate with Aegis via stdin/stdout. Each line is a JSON object.
 echo '{"event": "frame", "camera_id": "test", "frame_path": "/tmp/test.jpg"}' | python scripts/main.py
 ```
 
+## skills.json — Catalog Registration
+
+Register skills in the repo root `skills.json`:
+
+```json
+{
+  "skills": [
+    {
+      "id": "my-skill",
+      "name": "My Skill",
+      "description": "What it does",
+      "category": "detection",
+      "tags": ["tag1"],
+      "path": "skills/detection/my-skill",
+      "status": "testing",
+      "platforms": ["darwin-arm64", "linux-x64"]
+    }
+  ]
+}
+```
+
+### Status Values
+
+| Status | Emoji | Meaning |
+|--------|-------|---------|
+| `ready` | ✅ | Production-quality, tested |
+| `testing` | 🧪 | Functional, needs validation |
+| `experimental` | ⚗️ | Proof of concept |
+| `planned` | 📐 | Not yet implemented |
+
 ## Reference
 
 See [`skills/detection/yolo-detection-2026/`](../skills/detection/yolo-detection-2026/) for a complete working example.

skills/detection/yolo-detection-2026/config.yaml

@@ -3,6 +3,12 @@
 # Format: params[] with key, type, label, default, description, options
 
 params:
+  - key: auto_start
+    label: Auto Start
+    type: boolean
+    default: false
+    description: "Start this skill automatically when Aegis launches"
+
   - key: model_size
     label: Model Size
     type: select