feat: add bmad-install-agentvibes core skill

Adds a new core skill that guides users through installing AgentVibes
TTS so BMAD party mode agents speak with unique voices.

- New skill: src/core-skills/bmad-install-agentvibes/SKILL.md
  Documents npx agentvibes install, post-install voice config via
  /agent-vibes:bmad, and troubleshooting steps
- module-help.csv: registers skill with menu code AV under Core module

AgentVibes is cross-platform (Windows/Mac/Linux/WSL) and integrates
with bmad-party-mode so each agent speaks with their own distinct voice.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Paul Preibisch 2026-04-01 09:57:44 -07:00
parent 1aa0903e79
commit e6986fe867
2 changed files with 66 additions and 0 deletions

View File

@ -0,0 +1,65 @@
---
name: bmad-install-agentvibes
description: '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.'
---
# 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:
```bash
npx agentvibes install
```
Or if you prefer a global install first:
```bash
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
```bash
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
- GitHub: https://github.com/paulpreibisch/AgentVibes
- Docs: `agentvibes --help`

View File

@ -1,6 +1,7 @@
module,skill,display-name,menu-code,description,action,args,phase,after,before,required,output-location,outputs
Core,bmad-brainstorming,Brainstorming,BSP,Use early in ideation or when stuck generating ideas.,,anytime,,,false,{output_folder}/brainstorming,brainstorming session
Core,bmad-party-mode,Party Mode,PM,Orchestrate multi-agent discussions when you need multiple perspectives or want agents to collaborate.,,anytime,,,false,,
Core,bmad-install-agentvibes,Install AgentVibes,AV,Install AgentVibes TTS so party mode agents speak with unique voices. Run once after BMAD setup.,,anytime,,,false,,
Core,bmad-help,BMad Help,BH,,,anytime,,,false,,
Core,bmad-index-docs,Index Docs,ID,Use when LLM needs to understand available docs without loading everything.,,anytime,,,false,,
Core,bmad-shard-doc,Shard Document,SD,Use when doc becomes too large (>500 lines) to manage effectively.,[path],anytime,,,false,,

Can't render this file because it has a wrong number of fields in line 2.