symbiont skill: document skills infrastructure

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

symbiont/SKILL.md

@@ -578,6 +578,43 @@ python3 -m symbiont.main --task "Your prompt here"
 
 ---
 
+## Skills Infrastructure
+
+Symbiont also manages a **canonical skills repository** on cortex that serves as the source of truth for all Cowork skills.
+
+### Location
+- Git repo: `/data/skills/` on cortex
+- Packaged skills: `/data/skills/dist/*.skill`
+- Live download URL: `https://cortex.hydrascale.net/skills/<name>.skill`
+
+### Current skills hosted
+| Skill | Download |
+|-------|---------|
+| symbiont | https://cortex.hydrascale.net/skills/symbiont.skill |
+| cortex-server | https://cortex.hydrascale.net/skills/cortex-server.skill |
+
+### How it works
+- Every SKILL.md lives in `/data/skills/<name>/SKILL.md`
+- The Symbiont heartbeat (every 5 min) detects changes via `git status`, auto-commits, and re-runs `package_all.sh`
+- `package_all.sh` zips each skill directory into a `.skill` file in `/data/skills/dist/`
+- Caddy serves `/data/skills/dist/` at `https://cortex.hydrascale.net/skills/`
+
+### Installing a skill on a new device
+1. Visit `https://cortex.hydrascale.net/skills/` in a browser
+2. Download the `.skill` file
+3. Double-click to install in Cowork
+
+### Updating a skill
+Edit the SKILL.md directly on cortex:
+```bash
+nano /data/skills/<skill-name>/SKILL.md
+# Save — heartbeat will auto-commit and re-package within 5 minutes
+# Or force immediate packaging:
+bash /data/skills/package_all.sh
+```
+
+---
+
 ## Contact & Governance
 
 **Owner:** Michael Dwyer