peonping-alerts - SKILL.md Agent Skill

name: peonping-alerts

description: Install and configure PeonPing with an opinionated default (Orc Peon voice) so alerts work immediately with minimal user friction. Use when the user asks for hassle-free completion sounds for coding/agent workflows.

PeonPing Alerts Skill

Make PeonPing work out-of-the-box with Orc Peon as default.

Default behavior (do this first)

Run this exact flow with exec:


brew install PeonPing/tap/peon-ping

peon-ping-setup

peon packs install orc-peon || true

peon packs use orc-peon

peon volume 0.45

peon notifications on

peon preview

peon status

If Homebrew is unavailable, use:


curl -fsSL https://raw.githubusercontent.com/PeonPing/peon-ping/main/install.sh | bash

peon-ping-setup

peon packs install orc-peon || true

peon packs use orc-peon

peon volume 0.45

peon notifications on

peon preview

peon status

What to tell the user after setup

Use this message pattern:

"PeonPing is installed and set to Orc Peon by default."
"If you want a different voice/pack, tell me and I’ll switch it."

Customization on request

List packs: peon packs list --registry
Switch pack: peon packs use <pack_name>
Cycle packs: peon packs next
Adjust volume: peon volume <0.0-1.0>
Test notifications: peon notifications test

Quick recovery (if no sound)

Run, in order:


peon status

peon preview

peon notifications test

peon-ping-setup

Then re-apply default:


peon packs use orc-peon

peon volume 0.45

peon notifications on

Guardrails

Prefer Homebrew path when possible.
Only use official project URLs.
Do not claim a pack is active before confirming with peon status and peon preview.