Agent skill

Peon-Ping Sound Toggle

by PeonPing in 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.

MITAuto-check passedProductivity & Automation

Install Peon-Ping Sound Toggle

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

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

GitHub CLI
$ gh skill install PeonPing/peon-ping peon-ping-toggle --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-toggle .claude/skills/peon-ping-toggle && 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-toggle
GitHub stars
5.1k
Token cost
~427 tokens
SKILL.md length
143 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

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

  • Muting peon-ping sounds during a focused session
  • SKILL.md covers Toggle sounds, What This Toggles, Examples and Configuration changes
  • Calls bash
  • Resuming peon-ping sounds after a pause

What it does

The skill runs the peon-ping script from the hooks folder, through Bash on Unix or PowerShell on Windows, and reports whether sounds were paused or resumed. That switch is the master audio setting called enabled, so turning it off also stops desktop and mobile notifications, since those depend on sound being on.

If you only want to hide desktop popups while keeping the sounds, the skill points you to /peon-ping-config and its desktop_notifications setting instead. Other changes, such as volume, pack rotation, categories or the active pack, belong to the separate peon-ping-config skill.

When your agent uses it

  • Muting peon-ping sounds during a focused session
  • Resuming peon-ping sounds after a pause
  • Turning off sounds and notifications together

Example prompts

  • “Mute peon-ping completely.”
  • “Turn the peon sounds back on.”
  • “Just disable the desktop popups but keep the sounds.”

Requirements

  • peon-ping installed in the agent's hooks folder

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 Sound Toggle loads about 427 tokens when it runs. Until then it costs about 62 tokens; SKILL.md has 143 words of instructions outside code blocks.

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

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). 143 words, ~427 tokens.

Download SKILL.mdSave it as .claude/skills/peon-ping-toggle/SKILL.md (or your agent's skills folder).
name
peon-ping-toggle
description
Toggle peon-ping sound notifications on/off. Use when user wants to mute, unmute, pause, or resume peon sounds during a Claude Code session. Also handles config changes like volume, pack rotation, categories — any peon-ping setting.
user-invocable
true

peon-ping-toggle

Toggle peon-ping sounds on or off. Also handles any peon-ping configuration changes.

Toggle sounds

On Unix, run the following command using the Bash tool:

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

On Windows, use the PowerShell tool:

powershell
$claudeDir = $env:CLAUDE_CONFIG_DIR
if (-not $claudeDir -or $claudeDir -eq "") {
  $claudeDir = Join-Path $HOME ".claude"
}
& (Join-Path $claudeDir "hooks/peon-ping/peon.ps1") toggle

Report the output to the user. The command will print either:

  • peon-ping: sounds paused — sounds are now muted
  • peon-ping: sounds resumed — sounds are now active

What This Toggles

This command toggles the master audio switch (enabled config). When disabled:

  • ❌ Sounds stop playing
  • ❌ Desktop notifications also stop (they require sounds to be enabled)
  • ❌ Mobile notifications also stop

For notification-only control, use /peon-ping-config to set desktop_notifications: false. This keeps sounds playing while suppressing desktop popups.

Examples

"Mute peon-ping completely" → Sets enabled: false "Just disable the popups but keep sounds" → Sets desktop_notifications: false (use /peon-ping-config instead)

Configuration changes

For any other peon-ping setting changes (volume, pack rotation, categories, active pack, etc.), use the peon-ping-config skill.

© 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-toggle of PeonPing/peon-ping.

Open the folder on GitHubat commit de4ada7

Compare with similar skills

Peon-Ping Sound Toggle 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 Sound Toggle compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Peon-Ping Sound Toggle this skillPeonPing/peon-ping5.1k—~427Automated safety check: PassMIT
Hook Development for Claude Code Pluginsanthropics/claude-plugins-official38k11 repos~4.1kAutomated safety check: NotesApache-2.0
Plugin Settings Patternanthropics/claude-plugins-official38k7 repos~3kAutomated safety check: PassApache-2.0
Crush Configurationcharmbracelet/crush29k—~3.7kAutomated safety check: PassCustom licence
RayRailly/tinte624—~712Automated safety check: PassMIT
Hf Cloud Sagemaker Iam Preflightwaybarrios/opencode-power-pack533—~1.6kAutomated safety check: PassApache-2.0

Similar skills

  • Hook Development for Claude Code Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to write Claude Code plugin hooks, both prompt-based checks and bash commands, for events such as PreToolUse, Stop and SessionStart.

    38k GitHub starsUsed in 11 repos~4.1k tokens
    Agent WorkflowsAuto-check: notes
  • Plugin Settings Pattern

    anthropics/claude-plugins-official

    Official

    Shows how Claude Code plugins keep per-project settings and state in .claude/plugin-name.local.md files with YAML frontmatter and a markdown body.

    38k GitHub starsUsed in 7 repos~3k tokens
    Agent WorkflowsAuto-check passed
  • Crush Configuration

    charmbracelet/crush

    Explains how to configure the Crush coding agent with crushrc or crush.json, covering providers, models, LSPs, MCP servers, hooks, permissions and config precedence.

    29k GitHub stars~3.7k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Ray

    Railly/tinte

    Generate code screenshots via ray.tinte.dev API. An agent skill from Railly/tinte.

    624 GitHub stars~712 tokensUpdated 2 mo ago
    Frontend & DesignAuto-check passed
  • Hf Cloud Sagemaker Iam Preflight

    waybarrios/opencode-power-pack

    Verify or select a SageMaker execution role before creating models, endpoints, or training jobs.

    533 GitHub stars~1.6k tokensUpdated 2 days ago
    SecurityAuto-check passed
  • Tbtools

    xuzhougeng/wispterm

    A skill your agent uses when the user asks about TBtools, TBtools-II, TBtools RPC API, TBtools CLI, or bioinformatics operations available through TBtools such as sequence manipulation, BLAST…

    442 GitHub stars~2.3k tokensUpdated 2 days ago
    Research & ScienceAuto-check passed

More from PeonPing/peon-ping

  • Peon-Ping Settings Editor

    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.

    5.1k GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed
  • 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 yesterday
    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 yesterday
    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 yesterday
    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 yesterday
    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 yesterday
    Auto-check passed

Works with

Questions about Peon-Ping Sound Toggle

What does Peon-Ping Sound Toggle do?

Mutes or unmutes peon-ping sound notifications during an agent session with one command, and explains which settings the toggle also silences. The skill runs the peon-ping script from the hooks folder, through Bash on Unix or PowerShell on Windows, and reports whether sounds were paused or resumed. That switch is the master audio setting called enabled, so turning it off also stops desktop and mobile notifications, since those depend on sound being on.

When should I use Peon-Ping Sound Toggle?

Peon-Ping Sound Toggle fits situations like: muting peon-ping sounds during a focused session; resuming peon-ping sounds after a pause; turning off sounds and notifications together.

How do I install Peon-Ping Sound Toggle in Claude Code?

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

How do I install Peon-Ping Sound Toggle in Codex?

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

Can I use Peon-Ping Sound Toggle 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-toggle -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-toggle, .gemini/skills/peon-ping-toggle, .github/skills/peon-ping-toggle and .opencode/skills/peon-ping-toggle in your project.

What does Peon-Ping Sound Toggle need to run?

Going by SKILL.md and its folder, Peon-Ping Sound Toggle needs the command-line tools its instructions call (bash). Our summary lists: peon-ping installed in the agent's hooks folder.

Does Peon-Ping Sound Toggle 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 Sound Toggle 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 Sound Toggle use?

Peon-Ping Sound Toggle 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 Sound Toggle use?

About 427 tokens (SKILL.md is roughly 1.7k 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 Sound Toggle?

Skills that share tags, products or a category with Peon-Ping Sound Toggle: Hook Development for Claude Code Plugins (anthropics/claude-plugins-official, 38k stars), Plugin Settings Pattern (anthropics/claude-plugins-official, 38k stars), Crush Configuration (charmbracelet/crush, 29k stars) and Ray (Railly/tinte, 624 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Peon-Ping Sound Toggle?

PeonPing (a GitHub organization) maintains it in PeonPing/peon-ping, which has 5,066 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.