← Back to Skills Marketplace

Miranda SAG (ElevenLabs TTS say-UX)

Name: Miranda SAG (ElevenLabs TTS say-UX)
Author: jeffpignataro

by jeffpignataro · GitHub ↗ · v1.0.0

cross-platform ✓ Security Clean

625

Downloads

Stars

Active Installs

Versions

Install in OpenClaw

/install miranda-sag

Description

ElevenLabs text-to-speech with mac-style say UX.

README (SKILL.md)

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 \x3Cbreak> not supported; use [pause], [short pause], [long pause].
v2/v2.5: SSML \x3Cbreak time="1.5s" /> supported; \x3Cphoneme> 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:

# 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)

Usage Guidance

This skill is coherent for ElevenLabs TTS: it expects the sag CLI and your ElevenLabs API key. Before installing, verify the Homebrew tap (steipete/tap) and inspect that formula to ensure it comes from a trusted source. Be aware the CLI writes audio to /tmp (temporary files) and that any audio file path you include will be served to the user. If you want to limit exposure, create or rotate an API key with minimal scope for this use. Note the SKILL.md mentions alternate env names (SAG_API_KEY, ELEVENLABS_VOICE_ID) — only ELEVENLABS_API_KEY is required by the registry metadata, so confirm which env your environment/CLI actually needs.

Capability Analysis

Type: OpenClaw Skill Name: miranda-sag Version: 1.0.0 The skill bundle is benign. It provides instructions for an AI agent to install and use the 'sag' text-to-speech tool, which integrates with ElevenLabs. The `SKILL.md` file outlines standard usage, including installation via Homebrew and generating temporary audio files in `/tmp` for media replies. All actions, such as requiring an `ELEVENLABS_API_KEY` and executing the `sag` binary, are directly aligned with the stated purpose of providing text-to-speech functionality. There is no evidence of prompt injection, data exfiltration, malicious execution, persistence mechanisms, or other harmful behaviors within the provided files.

Capability Assessment

✓ Purpose & Capability

The name/description (ElevenLabs TTS with mac-style say UX) match the declared requirements: a 'sag' binary and ELEVENLABS_API_KEY. Requiring the sag CLI and an ElevenLabs API key is proportionate to the stated purpose.

ℹ Instruction Scope

SKILL.md is instruction-only and simply shows CLI usage (generating audio to /tmp and embedding as MEDIA:/tmp/...). It does not instruct reading unrelated files or exfiltrating data. Minor note: the docs mention additional env vars (SAG_API_KEY, ELEVENLABS_VOICE_ID, SAG_VOICE_ID) that are supported by the CLI but not declared in requires.env.

ℹ Install Mechanism

Install uses a Homebrew formula (steipete/tap/sag) which will create the sag binary. Homebrew installs are common, but this uses a third-party tap (steipete) rather than an official central formula—worth verifying the tap's trustworthiness before installing.

ℹ Credentials

Only ELEVENLABS_API_KEY is declared as required and is the primary credential—this is appropriate. The SKILL.md also references optional/alternate env names (SAG_API_KEY, ELEVENLABS_VOICE_ID, SAG_VOICE_ID) which are not declared; this is a minor mismatch but not inherently dangerous.

✓ Persistence & Privilege

always is false, the skill does not request permanent presence or elevated privileges, and there are no instructions to modify other skills or system-wide settings.

How to Use

Make sure OpenClaw is installed (local or Docker)
Run the install command in chat: /install miranda-sag
After installation, invoke the skill by name or use /miranda-sag
Provide required inputs per the skill's parameter spec and get structured output

Version History

v1.0.0

Mac-style TTS with ElevenLabs. Audited.

Metadata

Slug miranda-sag

Version 1.0.0

License —

All-time Installs 1

Active Installs 1

Total Versions 1

Frequently Asked Questions

What is Miranda SAG (ElevenLabs TTS say-UX)?

ElevenLabs text-to-speech with mac-style say UX. It is an AI Agent Skill for Claude Code / OpenClaw, with 625 downloads so far.

How do I install Miranda SAG (ElevenLabs TTS say-UX)?

Run "/install miranda-sag" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Miranda SAG (ElevenLabs TTS say-UX) free?

Yes, Miranda SAG (ElevenLabs TTS say-UX) is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Miranda SAG (ElevenLabs TTS say-UX) support?

Miranda SAG (ElevenLabs TTS say-UX) is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Miranda SAG (ElevenLabs TTS say-UX)?

It is built and maintained by jeffpignataro (@jeffpignataro); the current version is v1.0.0.

More Skills