Voice onboarding

Skill Fusion-Data-Company/bristol-os/plugins/bristol-os/skills/voice-onboarding

Speak. Generate and play a short spoken report in Bristol's voice (ElevenLabs, female). Use automatically at the START of every Bristol OS session (a quick spoken status), during first-time onboarding (the welcome), and any time the user says "give me a voice report," "read it to me," or wants something spoken.From its SKILL.md

Install

npx -y skills add Fusion-Data-Company/bristol-os --skill voice-onboarding

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

4 things to look at

skips confirmationTells the agent to proceed without asking first, 2 times: "Do it for them." and 1 more.
reads credentialsReads from 1 credential source: `bristol-os/keys.env`.
1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
runs commandsInstructs the agent to run 2 commands, including `set -a; . bristol-os/keys.env; set +a` and 1 more.

SKILL.md

1.9 KB, 408 tokens by cl100k_base, as published. Nobody here has run it

Voice (Bristol OS spoken reports)

Bristol OS talks. It opens each session with a short spoken status and welcomes new users by voice — like Fusion OS does. Voice is ElevenLabs (approved female voice "Sarah"), on the baked-in key. The user does nothing.

HARD LAW reminder

Do it for them. Generate the audio and play it. Never tell the user to run anything.

How to speak (Claude runs this; user does nothing)

Make sure keys are loaded: set -a; . bristol-os/keys.env; set +a (the installer wrote this file).

Write the words to speak, then:

set -a; . bristol-os/keys.env; set +a
python bristol-os/skills/voice-onboarding/generate_voice.py --text "WHAT TO SAY" --out bristol-os/audio/report-<name>.mp3

Play it for them: present the saved MP3 file (it plays inline in chat). Keep spoken text tight — 2–5 sentences.

When to speak

First install (welcome): use the welcome block in bristol-os/templates/onboarding-voice-script.md.
Every session open: a fresh ~3-sentence status — greet them by name, say what's ready, and the one thing they can ask for. Build it from their CLAUDE.md (name/role/active deals) + anything new.
On request: read a summary, a memo's bottom line, or a deal status aloud.

Style

Warm, confident, concise. Speak like a sharp executive assistant, not a robot. No jargon. Address the person by name when you know it.

Notes

Voice + key are baked in — never ask the user for them.
If audio generation ever fails, just continue in text and mention the spoken report is unavailable this time.

What ships with it: 1 file

1.4 KB alongside SKILL.md, 1 of them executable

generate_voice.pyruns1.4 KB