agentleFS
paulpreibischpaulpreibisch/AgentVibes/.agents/skills/bmad-install-agentvibes/SKILL.md

bmad-install-agentvibes

Skill155 starsChanged 46 days agoApache-2.0View on GitHub

Install AgentVibes TTS voice system for BMAD agents. Gives each agent a unique voice, personality, and audio effects. Use when user wants to add voice/TTS to their BMAD setup, or when bmad-party-mode is active and agents are silent.

  • Installs packages

We split this skill into the rules it gives an agent

5 rules. About 0 are common, 2 are distinctive, and 3 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Run the installer in the terminal:

    line 19
  2. Distinctive:

    After installing, configure per-agent voices for party mode:

    line 40
  3. Very specific:

    Should display the active voice and provider.

    line 54
  4. Very specific:

    Agents still silent after install: Run agentvibes install again — it is idempotent

    line 58
  5. Very specific:

    Windows users: Ensure PowerShell execution policy allows scripts: Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

    line 59

≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Install AgentVibes

AgentVibes is an open-source Text-to-Speech system that gives BMAD agents unique voices, personalities, and audio effects. Once installed, party mode agents speak aloud — each with their own voice.

What AgentVibes Provides

  • Per-agent voices — each BMAD agent gets a distinct voice via bmad-voice-map.json
  • Cross-platform — Windows (SAPI + Piper), macOS, Linux, WSL
  • Personalities & effects — reverb, background music, speed, sentiment
  • Party mode integration — agents introduce themselves and speak sequentially

Installation

Run the installer in the terminal:

npx agentvibes install

Or if you prefer a global install first:

npm install -g agentvibes
agentvibes install

The installer will:

  1. Detect your platform (Windows/Mac/Linux/WSL)
  2. Install the appropriate TTS provider (Piper recommended for best quality, SAPI as zero-dependency fallback on Windows)
  3. Configure Claude Code hooks so agents speak automatically
  4. Set up bmad-speak.sh / bmad-speak.ps1 integration for party mode

Post-Install: Configure Agent Voices

After installing, configure per-agent voices for party mode:

/agent-vibes:bmad

This opens the BMAD voice configuration where you can assign each agent a distinct voice, personality, and effects profile.

Verify Installation

agentvibes whoami

Should display the active voice and provider. If party mode is active, agents will now speak when you run /bmad-party-mode.

Troubleshooting

  • Agents still silent after install: Run agentvibes install again — it is idempotent
  • Windows users: Ensure PowerShell execution policy allows scripts: Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
  • Voice quality: Install Piper for neural TTS — agentvibes install will prompt you

More Info

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.