Agent skill

Peon-Ping Settings Editor

by PeonPing in PeonPing/peon-ping

Edits the peon-ping config file to change volume, sound packs, pack rotation, sound categories and notification options, then confirms the change.

MITAuto-check passedProductivity & Automation

Install Peon-Ping Settings Editor

skills CLI
$ npx skills add PeonPing/peon-ping --skill peon-ping-config -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install PeonPing/peon-ping peon-ping-config --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/PeonPing/peon-ping.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/peon-ping-config .claude/skills/peon-ping-config && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
peon-ping-config
GitHub stars
5.1k
Token cost
~1.2k tokens
SKILL.md length
408 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

Edits the peon-ping config file to change volume, sound packs, pack rotation, sound categories and notification options, then confirms the change.

  • Works in 3 steps: Read the config file using the Read tool → Edit the relevant field(s) using the… → Confirm the change to the user
  • Lowering or raising the volume of peon-ping sounds
  • SKILL.md covers Config location, Available settings, How to update and Common Configuration Examples, plus 2 more sections
  • Calls bash

What it does

Peon-ping plays sound notifications for coding agent events, and its settings live in `config.json` inside the `hooks/peon-ping` folder of the Claude config directory. The skill lists every supported key: volume, enabled, `default_pack`, `pack_rotation` and its mode (random, round-robin or per-session override), the on and off switches for each sound category, and `disabled_sounds` for muting single files.

Tuning options cover the rapid-prompt threshold and window that trigger spam sounds, a silent window that mutes completion sounds for short tasks, how many days stale per-session pack assignments are kept, desktop notification popups, and a macOS-only choice between the Sound Effects device and default output. To change anything, the agent reads the file, edits the relevant fields and tells you what changed; the `peon sounds` commands are preferred for muting individual files.

When your agent uses it

  • Lowering or raising the volume of peon-ping sounds
  • Switching the active sound pack or rotating through several packs
  • Turning individual sound categories on or off
  • Silencing one annoying sound file without disabling the whole pack

Example prompts

  • “Set peon-ping volume to half.”
  • “Rotate through the peon and glados packs in round-robin order.”
  • “Turn off the task error sounds but keep the session start sound.”
  • “Stop peon-ping from playing a sound when tasks finish in under ten seconds.”

Requirements

  • peon-ping installed, with its config file in the hooks folder

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Read the config file using the Read tool
  2. Edit the relevant field(s) using the Edit tool
  3. Confirm the change to the user

What it can do on your machine

Read from SKILL.md and the folder at commit de4ada7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • bash

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Peon-Ping Settings Editor loads about 1.2k tokens when it runs. Until then it costs about 67 tokens; SKILL.md has 408 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~67
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from PeonPing/peon-ping at commit de4ada7, republished under its MIT licence (© PeonPing). 408 words, ~1,235 tokens.

Download SKILL.mdSave it as .claude/skills/peon-ping-config/SKILL.md (or your agent's skills folder).
name
peon-ping-config
description
Update peon-ping configuration — volume, pack rotation, categories, active pack, and other settings. Use when user wants to change peon-ping settings like volume, enable round-robin, add packs to rotation, toggle sound categories, or adjust any config.
user-invocable
false

peon-ping-config

Update peon-ping configuration settings.

Config location

The config file is at ${CLAUDE_CONFIG_DIR:-$HOME/.claude}/hooks/peon-ping/config.json.

Available settings

  • volume (number, 0.0–1.0): Sound volume
  • default_pack (string): Current sound pack name (e.g. "peon", "sc_kerrigan", "glados"). Legacy key active_pack is also accepted as a fallback.
  • enabled (boolean): Master on/off switch
  • pack_rotation (array of strings): List of packs to rotate through per session. Empty [] uses default_pack only.
  • pack_rotation_mode (string): "random" (default) picks a random pack each session. "round-robin" cycles through in order. "session_override" uses explicit per-session assignments from /peon-ping-use; invalid or missing packs fall back to default_pack and the stale assignment is removed. Legacy value "agentskill" is accepted as an alias.
  • categories (object): Toggle individual CESP sound categories:
    • session.start, task.acknowledge, task.complete, task.error, input.required, resource.limit, user.spam — each a boolean
  • disabled_sounds (object): Disable specific sound files within a pack, keyed by pack name → category → array of filenames (basenames). Example:
    json
    "disabled_sounds": {
      "peon": { "session.start": ["Hello1.wav"] }
    }
    If every sound in a category is listed, that category stays silent. Prefer the CLI:
    bash
    peon sounds list [pack]
    peon sounds disable <category> <file> [--pack=<name>]
    peon sounds enable  <category> <file> [--pack=<name>]
  • annoyed_threshold (number): How many rapid prompts trigger user.spam sounds
  • annoyed_window_seconds (number): Time window for the annoyed threshold
  • silent_window_seconds (number): Suppress task.complete sounds for tasks shorter than this many seconds
  • session_ttl_days (number, default: 7): Expire stale per-session pack assignments older than N days (when using session_override mode)
  • desktop_notifications (boolean): Toggle notification popups independently from sounds (default: true)
  • use_sound_effects_device (boolean): Route audio through macOS Sound Effects device (true) or default output via afplay (false). Only affects macOS. Default: true
Show full SKILL.md (176 more words)Show less

How to update

  1. Read the config file using the Read tool
  2. Edit the relevant field(s) using the Edit tool
  3. Confirm the change to the user

Common Configuration Examples

Disable desktop notification popups but keep sounds

User request: "Disable desktop notifications"

Action: Set desktop_notifications: false in config

Result:

  • ✅ Sounds continue playing (voice reminders)
  • ❌ Desktop notification popups suppressed
  • ✅ Mobile notifications unaffected (separate toggle)

Alternative CLI command:

bash
peon notifications off
# or
peon popups off
Adjust volume

User request: "Set volume to 30%"

Action: Set volume: 0.3 in config

Enable round-robin pack rotation

User request: "Enable round-robin pack rotation with peon and glados"

Action: Set:

json
{
  "pack_rotation": ["peon", "glados"],
  "pack_rotation_mode": "round-robin"
}

Directory pack bindings

Permanently associate a sound pack with a working directory so every session in that directory uses the right pack automatically. Uses the path_rules config key (array of { "pattern": "<glob>", "pack": "<name>" } objects).

CLI commands
bash
# Bind a pack to the current directory
peon packs bind <pack>
# e.g. peon packs bind glados
# → bound glados to /Users/dan/Frontend

# Bind with a custom glob pattern (matches any dir with that name)
peon packs bind <pack> --pattern "*/Frontend/*"

# Auto-download a missing pack and bind it
peon packs bind <pack> --install

# Remove binding for the current directory
peon packs unbind

# Remove a specific pattern binding
peon packs unbind --pattern "*/Frontend/*"

# List all bindings (* marks rules matching current directory)
peon packs bindings
Manual config

The path_rules array in config.json can also be edited directly:

json
{
  "path_rules": [
    { "pattern": "/Users/dan/Frontend/*", "pack": "glados" },
    { "pattern": "*/backend/*", "pack": "sc_kerrigan" }
  ]
}

Patterns use Python fnmatch glob syntax. First matching rule wins. Path rules override default_pack and pack_rotation but are overridden by session_override assignments.

List available packs

To show available packs, run:

bash
bash "${CLAUDE_CONFIG_DIR:-$HOME/.claude}"/hooks/peon-ping/peon.sh packs list

© PeonPing, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/peon-ping-config of PeonPing/peon-ping.

Open the folder on GitHubat commit de4ada7

Compare with similar skills

Peon-Ping Settings Editor next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Peon-Ping Settings Editor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Peon-Ping Settings Editor this skillPeonPing/peon-ping5.1k—~1.2kAutomated safety check: PassMIT
cmux Diagnosticsmanaflow-ai/cmux28k1 repos~819Automated safety check: PassCustom licence
OpenGUI Installer for DSHCore-Mate/OpenGUI1.8k—~1.1kAutomated safety check: PassCustom licence
OpenGUI Plugin InstallerCore-Mate/OpenGUI1.8k—~1kAutomated safety check: PassCustom licence
Build And Run macOS Approbinebers/openusage4.3k—~473Automated safety check: PassMIT
Fix Codesign Errorrobinebers/openusage4.3k—~280Automated safety check: PassMIT

Similar skills

  • cmux Diagnostics

    manaflow-ai/cmux

    Runs a read-only health check for cmux and explains what it finds, covering the CLI and socket, settings, agent hooks, session restore and notifications.

    28k GitHub starsUsed in 1 repo~819 tokens
    Productivity & AutomationAuto-check passed
  • OpenGUI Installer for DSH

    Core-Mate/OpenGUI

    Installs and verifies the latest stable OpenGUI release in a DeepSeek Harness web profile on macOS without disturbing existing plugins or settings.

    1.8k GitHub stars~1.1k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • OpenGUI Plugin Installer

    Core-Mate/OpenGUI

    Installs or upgrades the standalone OpenGUI plugin for Codex or WorkBuddy on macOS from verified prebuilt GitHub releases, checking the SHA-256 before running anything.

    1.8k GitHub stars~1k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Build And Run macOS App

    robinebers/openusage

    Slash command that creates or updates the project-local macOS script/buildandrun.sh and uses it as the default build/run entrypoint.

    4.3k GitHub stars~473 tokensUpdated 3 days ago
    Agent WorkflowsAuto-check passed
  • Fix Codesign Error

    robinebers/openusage

    Slash command that inspects a macOS signing or entitlement failure and explains the minimum fix path.

    4.3k GitHub stars~280 tokensUpdated 3 days ago
    Agent WorkflowsAuto-check passed
  • Test macOS App

    robinebers/openusage

    Slash command that runs the smallest meaningful macOS test scope first and explains failures by category.

    4.3k GitHub stars~273 tokensUpdated 3 days ago
    Agent WorkflowsAuto-check passed

More from PeonPing/peon-ping

  • Peon-Ping Session Rename

    PeonPing/peon-ping

    Gives the current coding session a custom name that appears in peon-ping desktop notification titles and the terminal tab title, or resets it to automatic.

    5.1k GitHub stars~539 tokensUpdated 3 days ago
    Auto-check passed
  • Switches which character voice pack (GLaDOS, Peon, Kerrigan and others) plays for the current chat session in Peon Ping.

    5.1k GitHub stars~1.2k tokensUpdated 3 days ago
    Auto-check passed
  • Peon Trainer Rep Logger

    PeonPing/peon-ping

    Log exercise reps for the Peon Trainer. Use when user says they did pushups, squats, or wants to log reps. Examples - "/peon-ping-log 25 pushups"…

    5.1k GitHub stars~286 tokensUpdated 3 days ago
    Auto-check passed
  • Peon-Ping Sound Toggle

    PeonPing/peon-ping

    Mutes or unmutes peon-ping sound notifications during an agent session with one command, and explains which settings the toggle also silences.

    5.1k GitHub stars~427 tokensUpdated 3 days ago
    Auto-check passed
  • PeonPing Pack Creator

    PeonPing/peon-ping

    Drafts a new PeonPing notification sound pack across seven event categories for a given name, flavor and vibe, when called headlessly by peon create.

    5.1k GitHub stars~1.7k tokensUpdated 3 days ago
    Auto-check passed
  • Peon Ping Sound Reroll

    PeonPing/peon-ping

    Internal skill that rewrites and re-renders sound prompts in a draft PeonPing pack to follow a reroll caption, then records the change in a log.

    5.1k GitHub stars~910 tokensUpdated 3 days ago
    Auto-check passed

Works with

Questions about Peon-Ping Settings Editor

What does Peon-Ping Settings Editor do?

Edits the peon-ping config file to change volume, sound packs, pack rotation, sound categories and notification options, then confirms the change. json` inside the `hooks/peon-ping` folder of the Claude config directory. The skill lists every supported key: volume, enabled, `default_pack`, `pack_rotation` and its mode (random, round-robin or per-session override), the on and off switches for each sound category, and `disabled_sounds` for muting single files.

When should I use Peon-Ping Settings Editor?

Peon-Ping Settings Editor fits situations like: lowering or raising the volume of peon-ping sounds; switching the active sound pack or rotating through several packs; turning individual sound categories on or off; silencing one annoying sound file without disabling the whole pack.

How do I install Peon-Ping Settings Editor in Claude Code?

Run `npx skills add PeonPing/peon-ping --skill peon-ping-config -a claude-code`. Or copy the skill folder (skills/peon-ping-config in PeonPing/peon-ping) into .claude/skills/peon-ping-config in your project. Claude Code loads it when a task matches its description.

How do I install Peon-Ping Settings Editor in Codex?

Run `npx skills add PeonPing/peon-ping --skill peon-ping-config -a codex`. Or copy the skill folder (skills/peon-ping-config in PeonPing/peon-ping) into .agents/skills/peon-ping-config in your project. Codex loads it when a task matches its description.

Can I use Peon-Ping Settings Editor in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add PeonPing/peon-ping --skill peon-ping-config -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/peon-ping-config, .gemini/skills/peon-ping-config, .github/skills/peon-ping-config and .opencode/skills/peon-ping-config in your project.

What does Peon-Ping Settings Editor need to run?

Going by SKILL.md and its folder, Peon-Ping Settings Editor needs the command-line tools its instructions call (bash). Our summary lists: peon-ping installed, with its config file in the hooks folder.

Does Peon-Ping Settings Editor access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Peon-Ping Settings Editor safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Peon-Ping Settings Editor use?

Peon-Ping Settings Editor is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Peon-Ping Settings Editor use?

About 1.2k tokens (SKILL.md is roughly 4.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Peon-Ping Settings Editor?

Skills that share tags, products or a category with Peon-Ping Settings Editor: cmux Diagnostics (manaflow-ai/cmux, 28k stars), OpenGUI Installer for DSH (Core-Mate/OpenGUI, 1.8k stars), OpenGUI Plugin Installer (Core-Mate/OpenGUI, 1.8k stars) and Build And Run macOS App (robinebers/openusage, 4.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Peon-Ping Settings Editor?

PeonPing (a GitHub organization) maintains it in PeonPing/peon-ping, which has 5,068 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 6, 2026.

Source: PeonPing/peon-ping on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.