peon-ping Config Manager
Easily tweak peon-ping's volume, pack rotation, categories, and more by editing its config file.
The skill only instructs reading and editing config.json, with no network requests or commands, minimal permissions. However, lacks rollback mechanism, user confirmation is not explicitly enforced, and sensitive data flow not disclosed. Publisher unverified but not penalized itself. Deduction: relatively safe permissions, but rollback, explicit confirmation, and data-flow transparency incomplete.
Path and config fields clearly described, but no tests cover this skill's key paths. Repo has tests for OpenCode adapter and Antigravity watcher, not this config skill. Static review caps reliability at 10, but shared CI/tests provide partial evidence. Deduction: no direct tests, error handling (e.g., corrupt JSON) not explained.
Clearly defines use case (modifying config) and triggers, but does not declare non-fit scenarios (e.g., when config absent). Environment fit: description in English, no Chinese support declared; core function depends on local config, not overseas services, but mainland reachability not addressed. Deduction: no explicit boundaries and non-fit, Chinese support unaddressed.
Documentation structure clear with settings list and examples, but lacking version, changelog, and maintenance responsibility. No FAQ or troubleshooting. License present, publisher unverified but maintenance via GitHub Actions evident. Deduction: no version info, changelog, and explicit maintenance responsibility.
Skill can complete core task of modifying config, but no representative output verified. No user reports or tests prove actual effectiveness. Static review caps at 7, but repo has CI/tests as partial evidence, though not covering this skill. Deduction: output unverified, marginal value lower than CLI commands (CLI has more verification).
Repo has CI workflows (release, test-opencode-adapter) and test files, but not covering this skill path. Static review caps at 5. Deduction: no direct verification for this skill, functionality depends on other repo modules.
- No rollback mechanism provided; consider backing up original config before changes.
- User confirmation not enforced; recommend explicit confirmation for high-impact settings (e.g., disabling notifications).
- Chinese language support not declared; description is English, may hinder Chinese users.
- No troubleshooting or error handling guidance (e.g., missing config, corrupt JSON).
What does this skill do, and when should you use it?
This skill updates peon-ping's configuration file located at `~/.claude/hooks/peon-ping/config.json`. It lets you adjust volume, enable or disable sound pack rotation, toggle sound categories, set the active pack, and manage various other settings. It's useful for users who want to customize their sound alert experience while using AI coding agents like Claude Code. The skill provides clear documentation of config keys and common examples, and recommends CLI commands as an alternative.
Reads and edits the configuration file at ${CLAUDE_CONFIG_DIR:-$HOME/.claude}/hooks/peon-ping/config.json. Specifically, it can: set volume (0.0–1.0), switch default pack, enable/disable master switch, configure pack rotation list and mode (random, round-robin, session_override), toggle individual CESP sound categories (session.start, task.complete, etc.), disable specific sound files, set threshold and window for user.spam detection, set silent window, session TTL, desktop notification toggle, audio output device option, and manage path rules for directory-based pack binding.
- User wants to lower volume to 30% — skill sets `volume: 0.3`.
- User wants to enable round-robin rotation between peon and glados packs — skill sets `pack_rotation` and `pack_rotation_mode`.
- User wants to disable desktop notifications but keep sounds — skill sets `desktop_notifications: false`.
- User wants to permanently bind a pack (e.g., glados) to a directory — skill modifies `path_rules`.
- User wants to disable a specific sound file in a category (e.g., Hello1.wav in session.start) — skill updates `disabled_sounds`.
What are this skill's strengths and limitations?
- Covers all config options, from volume to advanced rotation rules.
- Provides concrete examples for common use cases, making it quick to act.
- Recommends CLI commands for simpler and less error-prone changes.
- The skill only edits configuration; it does not manage sound files themselves.
- Requires peon-ping to be installed and config file present.
- Advanced features like session_override may require extra understanding.
How do you install this skill?
This skill ships with the peon-ping repository at skills/peon-ping-config/SKILL.md. Install peon-ping, then place the skill folder into your Claude Code skills directory (e.g., ~/.claude/skills/).
How do you use this skill?
In Claude Code, simply ask Claude to change a setting, e.g., "Set volume to 30%" or "Enable round-robin rotation." The skill will read the config file, edit the relevant fields, and confirm the change. Alternatively, use CLI commands like peon volume 0.3 or peon notifications off.