Dev & Engineering

Peon Sound Toggle

Mute or resume Peon sound notifications in Claude Code with a single command.

56/ 100
Use with care

Useful, but reliability, evidence or controls still have material gaps.

See how it was scored ↓
Works as-is in
Codex · Claude Code
Stars
★ 5.1k
Last updated
5d ago
License
MIT
sound-notificationsproductivityaudio-alertstoggle

What does this skill do, and when should you use it?

This skill controls the audio notification master switch for peon-ping. It toggles all sounds and desktop notifications on/off instantly, perfect for meetings or focused work. It also handles other configuration changes like volume, pack rotation, and categories, though those are delegated to a companion skill /peon-ping-config. Extracted from a larger multi-skill repository, this skill focuses on quick mute/unmute control.

The skill invokes peon.sh or peon.ps1 with the 'toggle' argument to flip the enabled config flag. It reports the output which clearly states whether sounds are paused or resumed. It does not modify any other settings; configuration changes such as volume or pack rotation are handled by the /peon-ping-config skill.

Good fit
  • During a meeting or presentation, a user wants to quickly mute all Peon sounds and desktop notifications to avoid disruption.
  • A user wants to pause sounds but keep desktop notifications visible, e.g., to focus on a task while still seeing alerts.
  • After the meeting, the user wants to resume sounds with a single command.
  • In a Claude Code session, a user prefers voice commands over manual config file editing for quick sound control.

How do you install this skill?

Before you use it
  • The skill is only triggered by explicit user invocation, but no rollback or confirmation for config changes is provided.
  • The skill depends on the peon-ping hook being properly installed; if missing, the command may fail without diagnostic hints.
  • Static review cannot verify the script's actual behavior; test before use.
Before you start
Your agent needs
  • Shell / CLI
  • Local filesystem

This skill is part of the peon-ping repository. Follow the README installation steps (Homebrew or installer script) to install peon-ping, which copies the skill folder to Claude Code's skills directory (usually ~/.claude/skills/). The skill depends on the peon-ping hooks being properly installed.

Generic route: install into Claude Code manually (macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/PeonPing/peon-ping.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/peon-ping-toggle" ~/.claude/skills/
rm -rf "$tmp"

Generated from the source repository and skill path; it copies only this skill's folder. If the author's install steps above differ, follow those first. To scope it to one project, replace ~/.claude/skills with that project's .claude/skills.

How do you use this skill?

Try saying

Once installed, send your agent any of these to trigger it:

  • resume peon sounds

In Claude Code, simply tell Claude 'mute peon' or 'resume peon sounds' and the skill will execute the toggle command automatically. The skill is also available as a slash command /peon-ping-toggle. After execution, Claude reports the new state. For disabling only desktop notifications while keeping sounds, use the /peon-ping-config skill to set desktop_notifications: false.

What are this skill's strengths and limitations?

Pros
  • Quick and easy mute/unmute in one command.
  • Controls both sounds and desktop notifications together.
  • Cross-platform support for Unix and Windows.
  • Simple installation via peon-ping's installer.
Limitations
  • Only controls the master switch, not fine-grained per-category control.
  • Requires peon-ping to be installed with proper Claude Code hooks configured.
  • State does not auto-resume; user must explicitly toggle again.
  • No mention of tests, potential issues on untested platforms.

How does this skill compare with similar options?

Side by side with related skills; every score comes from the same FSRS standard.

Skill FS score Stars Last updated License
Peon Sound Toggle this page 56 · Use with care ★ 5.1k 5d ago MIT
peon-ping Rename Session 53 · Use with care ★ 5.1k 5d ago MIT
Trae High-Agency Governance Skill 43 · Not recommended ★ 20k 1mo ago —
peon-ping Config Manager 64 · Recommended ★ 5.1k 5d ago MIT
Video Processor 63 · Recommended ★ 1.5k 8mo ago —

How did FollowSkills review this skill?

FollowSkills review · FSRS-2.0
Use with care
56/ 100 5-point scale 2.8 / 5
The upstream repository has new commits since this review. The score still applies to the reviewed revision shown and may not cover the latest changes.
1Trust20 / 25 · 4.0/5

The skill executes a simple toggle command, only reads/writes local config files, no sensitive data transfer or external network side effects. It is invoked by explicit user request (in Claude Code), following least privilege. However, no explicit rollback or confirmation prompt for config changes. Score 20.

2Reliability8 / 20 · 2.0/5

Skill instructions are clear, providing specific commands for Unix and Windows, but do not include error handling for abnormal inputs (e.g., missing config) or mention tests. Static assessment only allows 8.

3Adaptability8 / 15 · 2.7/5

Objective is clear (toggle peon-ping sounds), but no explicit boundaries or non-fit scenarios declared. Environment fit is good (Unix/Windows), and no dependency on overseas services, so mainland China reachability is not an issue. Score 8.

4Convention10 / 15 · 3.3/5

Skill file is well-structured with description, examples, and config notes, but lacks versioning, changelog, or maintenance responsibility. License is clear at repo level (MIT) but not in SKILL.md. Score 10.

5Effectiveness7 / 15 · 2.3/5

Core function (toggle sounds) is reasonable and likely works, but no execution verify. Expected output is described, but static review cannot confirm actual effect. This dimension caps at 7; score 7.

6Verifiability3 / 10 · 1.5/5

Repo has tests (e.g., for opencode adapter), but they don't cover this skill's command logic. No third-party execution evidence. Score 3.

1 2 3 4 5 6

Open a dimension to read why it scored that way

Reviewed Aug 07, 2026 Reviewed revision fef63cfdb134 Review evidence[1][2][3][4][5][6][7]

Evidence confidence:Low — Mostly static review, author material or a limited demo; useful for discovery, not high-risk decisions.

See the full review method →

FAQ

Does this skill modify my config file?
No, it only runs the toggle command and does not directly edit config files. Any setting changes (e.g., volume, packs) require the /peon-ping-config skill.
Does muting also stop desktop notifications?
Yes, when the master switch is off, sounds, desktop notifications, and mobile notifications are all disabled.
Can I use this on Windows?
Yes, the skill provides a PowerShell command for Windows environments.
Will the state automatically resume?
No, the state persists until you toggle again. For automatic muting based on Focus mode, configure focus_detect in peon-ping.

More skills from this repository

All from PeonPing/peon-ping

Related skills