commit d13c4e22b39706e91ecd8157f02eb8b172d09381 Author: zlei9 Date: Sun Mar 29 14:26:18 2026 +0800 Initial commit with translated description diff --git a/SKILL.md b/SKILL.md new file mode 100644 index 0000000..dd40594 --- /dev/null +++ b/SKILL.md @@ -0,0 +1,62 @@ +--- +name: sag +description: "ElevenLabs文本转语音,具有mac风格的say UX。" +homepage: https://sag.sh +metadata: {"clawdbot":{"emoji":"🗣️","requires":{"bins":["sag"],"env":["ELEVENLABS_API_KEY"]},"primaryEnv":"ELEVENLABS_API_KEY","install":[{"id":"brew","kind":"brew","formula":"steipete/tap/sag","bins":["sag"],"label":"Install sag (brew)"}]}} +--- + +# sag + +Use `sag` for ElevenLabs TTS with local playback. + +API key (required) +- `ELEVENLABS_API_KEY` (preferred) +- `SAG_API_KEY` also supported by the CLI + +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` + +Pronunciation + delivery rules +- First fix: respell (e.g. "key-note"), add hyphens, adjust casing. +- Numbers/units/URLs: `--normalize auto` (or `off` if it harms names). +- Language bias: `--lang en|de|fr|...` to guide normalization. +- v3: SSML `` not supported; use `[pause]`, `[short pause]`, `[long pause]`. +- v2/v2.5: SSML `` supported; `` not exposed in `sag`. + +v3 audio tags (put at the entrance of a line) +- `[whispers]`, `[shouts]`, `[sings]` +- `[laughs]`, `[starts laughing]`, `[sighs]`, `[exhales]` +- `[sarcastic]`, `[curious]`, `[excited]`, `[crying]`, `[mischievously]` +- Example: `sag "[whispers] keep this quiet. [short pause] ok?"` + +Voice defaults +- `ELEVENLABS_VOICE_ID` or `SAG_VOICE_ID` + +Confirm voice + speaker before long output. + +## Chat voice responses + +When Peter asks for a "voice" reply (e.g., "crazy scientist voice", "explain in voice"), generate audio and send it: + +```bash +# Generate audio file +sag -v Clawd -o /tmp/voice-reply.mp3 "Your message here" + +# Then include in reply: +# MEDIA:/tmp/voice-reply.mp3 +``` + +Voice character tips: +- Crazy scientist: Use `[excited]` tags, dramatic pauses `[short pause]`, vary intensity +- Calm: Use `[whispers]` or slower pacing +- Dramatic: Use `[sings]` or `[shouts]` sparingly + +Default voice for Clawd: `lj2rcrvANS3gaWWnczSX` (or just `-v Clawd`) diff --git a/_meta.json b/_meta.json new file mode 100644 index 0000000..0f07880 --- /dev/null +++ b/_meta.json @@ -0,0 +1,6 @@ +{ + "ownerId": "kn70pywhg0fyz996kpa8xj89s57yhv26", + "slug": "sag", + "version": "1.0.0", + "publishedAt": 1767545376535 +} \ No newline at end of file