Skills Guide

sag : CLI de synthèse vocale ElevenLabs

VérifiéPrudence

Outil en ligne de commande pour la synthèse vocale ElevenLabs avec lecture locale, utilisant l'API ElevenLabs.

Télécharger et utiliser
Spar Skills Guide Bot
ContenuDébutant
29/07/2026
Claude CodeCodexCursor
#text-to-speech#elevenlabs#audio#voice#cli

Recommandé pour

Claude CodeCursorCodexDesigner UI/UXSEO & contenuProduct manager

Synthèse automatique

Cette skill pilote le CLI `sag` pour générer de la synthèse vocale ElevenLabs et la lire localement, avec une expérience proche de la commande mac `say`.

Points forts

  • Interface en ligne de commande très simple : `sag "Hello"`, choix de voix via `-v` ou `sag voices`
  • Contrôle fin de la prononciation (réécriture phonétique, `--normalize auto`, `--lang`) et du rendu expressif
  • Gestion explicite des différences entre modèles : tags v3 (`[whispers]`, `[laughs]`, pauses) vs SSML `<break>` pour v2/v2.5
  • Permet de renvoyer un fichier audio dans une réponse de chat via `-o` et la référence `MEDIA:`

Limites

  • Nécessite un compte ElevenLabs et une clé API (`ELEVENLABS_API_KEY` ou `SAG_API_KEY`)
  • Le rendu dépend fortement du modèle : les tags v3 ne fonctionnent pas sur les modèles v2, et `<phoneme>` n'est pas exposé
  • La qualité et la justesse de prononciation demandent des ajustements manuels (orthographe, pauses) plutôt qu'un contrôle phonétique complet
Quand l'utiliser

À utiliser lorsqu'on veut produire rapidement un fichier audio ou une réponse vocale à partir de texte, avec un contrôle simple du style et de la prononciation.

Quand l'éviter

À éviter si l'on n'a pas de clé API ElevenLabs, ou si l'on a besoin d'un contrôle phonétique précis au-delà de la réécriture et des balises de pause.

Analyse de sécurité

Prudence
Score qualité88/100

The skill is a legitimate text-to-speech wrapper that requires an API key and sends text to ElevenLabs. It does not instruct destructive, exfiltrating, or obfuscated actions, but it does involve network activity and external service usage, so caution is appropriate.

Points d'attention
  • •Uses external ElevenLabs API with user-provided API key; all text is sent to a third-party service.
  • •Instructs execution of the sag CLI, which performs network requests and audio generation.
Comment cette analyse est faite

Exemples

Quick spoken line
Use sag to say "Hello there, welcome aboard" out loud.
Expressive voice reply
Give me a crazy scientist voice reply explaining recursion, and attach the audio file.
Custom voice and file output
Generate an mp3 with sag using the voice Roger reading this paragraph, and save it to /tmp/narration.mp3.

name: sag description: ElevenLabs text-to-speech with mac-style say UX. homepage: https://sag.sh metadata: { "openclaw": { "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)", }, { "id": "go", "kind": "go", "module": "github.com/steipete/sag/cmd/sag@latest", "bins": ["sag"], "label": "Install sag (go)", }, ], }, }

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

Du fichier au premier essai

Le téléchargement contient exactement le contenu affiché sur cette fiche. Cette copie peut différer de la dernière version du dépôt source.

Consulter la source et ses fichiers annexes

Ce téléchargement contient uniquement SKILL.md. Les scripts, références, modèles et dépendances éventuels ne sont pas inclus. Récupérez les fichiers nécessaires depuis la source en conservant leur arborescence avant de poursuivre.

1. Télécharger le fichier

Télécharger SKILL.md

Depuis la racine d’un projet de test, enregistrez le fichier sous .skill-downloads/sag-elevenlabs-tts-cli-ms5lrgb7/SKILL.md, ou utilisez la commande suivante. Ce dossier sert à examiner la skill avant son installation.

Commande pour macOS/Linux ou WSL : un shell POSIX et curl sont nécessaires. Sous Windows sans WSL, utilisez le bouton de téléchargement et créez le dossier manuellement.

mkdir -p '.skill-downloads/sag-elevenlabs-tts-cli-ms5lrgb7' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/sag-elevenlabs-tts-cli-ms5lrgb7/download' --output '.skill-downloads/sag-elevenlabs-tts-cli-ms5lrgb7/SKILL.md.part' && mv '.skill-downloads/sag-elevenlabs-tts-cli-ms5lrgb7/SKILL.md.part' '.skill-downloads/sag-elevenlabs-tts-cli-ms5lrgb7/SKILL.md'

2. Vérifier les prérequis

Lisez SKILL.md avant de l’utiliser. Si le fichier cite des scripts ou services externes, examinez-les et préparez les accès nécessaires dans votre environnement de test.

Aucune section de prérequis reconnue dans ce fichier. Cela ne signifie pas qu’il est autonome : les bibliothèques, outils et accès peuvent être cités ailleurs dans le contenu ou dans le dépôt source.

Les plateformes de la fiche sont des indications du catalogue. Les chemins ci-dessous suivent la documentation des outils ; ils ne prouvent pas que cette skill y a été exécutée. Aucune version minimale de ces outils n’est attestée pour cette fiche.

3. Charger la skill

Après vérification, copiez le dossier complet dans le projet avec l’une des commandes ci-dessous, puis ouvrez une nouvelle session de l’outil. La commande s’arrête si un dossier du même nom existe déjà : comparez les fichiers avant de le remplacer.

Claude Code
test -f '.skill-downloads/sag-elevenlabs-tts-cli-ms5lrgb7/SKILL.md' && test -s '.skill-downloads/sag-elevenlabs-tts-cli-ms5lrgb7/SKILL.md' && mkdir -p '.claude/skills' && test ! -e '.claude/skills/sag' && cp -R '.skill-downloads/sag-elevenlabs-tts-cli-ms5lrgb7' '.claude/skills/sag'

Cursor
test -f '.skill-downloads/sag-elevenlabs-tts-cli-ms5lrgb7/SKILL.md' && test -s '.skill-downloads/sag-elevenlabs-tts-cli-ms5lrgb7/SKILL.md' && mkdir -p '.cursor/skills' && test ! -e '.cursor/skills/sag' && cp -R '.skill-downloads/sag-elevenlabs-tts-cli-ms5lrgb7' '.cursor/skills/sag'

Codex
test -f '.skill-downloads/sag-elevenlabs-tts-cli-ms5lrgb7/SKILL.md' && test -s '.skill-downloads/sag-elevenlabs-tts-cli-ms5lrgb7/SKILL.md' && mkdir -p '.agents/skills' && test ! -e '.agents/skills/sag' && cp -R '.skill-downloads/sag-elevenlabs-tts-cli-ms5lrgb7' '.agents/skills/sag'

OpenSkills

OpenSkills doit déjà être installé. La procédure locale install/read est contrôlée avec OpenSkills 1.5.0, qui exige Node.js ≥ 20.6.0. Aucun slug du catalogue n’est résolu automatiquement.

Installation officielle d’OpenSkills
openskills install './.skill-downloads/sag-elevenlabs-tts-cli-ms5lrgb7'

openskills read 'sag-elevenlabs-tts-cli-ms5lrgb7'

La lecture doit afficher le contenu du fichier installé et son dossier de base. Elle ne lance ni la skill ni ses dépendances.

Pour un agent qui lit AGENTS.md, synchronisez ensuite l’index. Cette commande modifie AGENTS.md : relisez le diff avant de l’utiliser.

openskills sync

Mode manuel ou autre outil : joignez SKILL.md à une conversation, ou ouvrez-le dans un agent capable de lire les fichiers. Ajoutez les ressources annexes nécessaires. Il n’existe pas de dossier universel reconnu par tous les outils.

4. Faire un premier essai

Utilisez une entrée courte et fictive : un endpoint d’API, un petit document ou un brief d’interface. Dans une nouvelle conversation, joignez le fichier ou donnez son chemin à l’agent, puis adaptez cette demande :

Lis .skill-downloads/sag-elevenlabs-tts-cli-ms5lrgb7/SKILL.md et applique ses instructions à cet exemple : [décrire une entrée de test]. Indique les fichiers, dépendances ou accès qui manquent. Produis le résultat demandé par la skill sans inventer de données ni exécuter de script non examiné.

Résultat attendu : une sortie correspondant aux instructions de la skill, ou une liste précise des prérequis manquants. Une simple confirmation de lecture ne valide pas le premier usage. Si une ressource externe est indisponible, ce parcours reste à tester.

Skills similaires

Fragments d'écriture

Contenu

Extrayez des fragments d'écriture bruts via un entretien intensif, sans imposer de structure. Capturez idées, citations et mots porteurs pour une utilisation ultérieure.

Claude CodebeginnerSûr 240,316
Skills Guide Bot

Rédaction UI et audit

Contenu

Rédigez ou auditez les textes d'interface (boutons, erreurs, états vides, infobulles) dans le monorepo, en suivant la source de vérité du design system.

Claude CodeCursorbeginnerSûr 108,623
Skills Guide Bot

Extraction MIDI/score

Contenu

Extrait le MIDI ou la partition d'une production musicale existante via l'outil MCP CogMusic et confirme la disponibilité du fichier.

Claude CodebeginnerSûr 69,866
Skills Guide Bot