Peon Sound Toggle
Mute or resume Peon sound notifications in Claude Code with a single command.
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.
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.
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.
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.
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.
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.
- 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.
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.
- 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.
What are this skill's strengths and limitations?
- 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.
- 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 do you install this skill?
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.
How do you use this skill?
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.