docs: refine skills

skills/sag/SKILL.md

@@ -1,15 +1,29 @@
 ---
 name: sag
 description: ElevenLabs text-to-speech with mac-style say UX.
-metadata: {"clawdis":{"requires":{"bins":["sag"]}}}
+metadata: {"clawdis":{"requires":{"bins":["sag"],"env":["ELEVENLABS_API_KEY"]},"primaryEnv":"ELEVENLABS_API_KEY"}}
 ---
 
 # sag
 
-Use `sag` to speak or stream text to speakers. Start with:
+Use `sag` for ElevenLabs TTS with local playback.
 
-```bash
-sag --help
-```
+API key (required)
+- `ELEVENLABS_API_KEY` (preferred)
+- `SAG_API_KEY` also supported by the CLI
 
-Confirm the voice/speaker before long output.
+Quick start
+- `sag "Hello there"`
+- `sag speak -v "Roger" "Hello"`
+- `sag voices`
+- `sag prompting` (model-specific tips)
+
+Model notes
+- Default: `eleven_v3` (expressive)
+- Stable: `eleven_multilingual_v2`
+- Fast: `eleven_flash_v2_5`
+
+Voice defaults
+- `ELEVENLABS_VOICE_ID` or `SAG_VOICE_ID`
+
+Confirm voice + speaker before long output.