docs: refine skills

skills/eightctl/SKILL.md

@@ -1,15 +1,28 @@
 ---
 name: eightctl
-description: Control sleep workflows with eightctl.
+description: Control Eight Sleep pods (status, temperature, alarms, schedules).
 metadata: {"clawdis":{"requires":{"bins":["eightctl"]}}}
 ---
 
 # eightctl
 
-Use `eightctl` for sleep/wake automation. Start with:
+Use `eightctl` for Eight Sleep pod control. Requires auth.
 
-```bash
-eightctl --help
-```
+Auth
+- Config: `~/.config/eightctl/config.yaml`
+- Env: `EIGHTCTL_EMAIL`, `EIGHTCTL_PASSWORD`
 
-Confirm before scheduling disruptive actions.
+Quick start
+- `eightctl status`
+- `eightctl on|off`
+- `eightctl temp 20`
+
+Common tasks
+- Alarms: `eightctl alarm list|create|dismiss`
+- Schedules: `eightctl schedule list|create|update`
+- Audio: `eightctl audio state|play|pause`
+- Base: `eightctl base info|angle`
+
+Notes
+- API is unofficial and rate-limited; avoid repeated logins.
+- Confirm before changing temperature or alarms.