peon-ping-use

Set which voice pack (character voice) plays for the current chat session.

How it works

When the user types

/peon-ping-use

, a

beforeSubmitPrompt hook

intercepts the command before it reaches the model and handles it instantly:

Validates the requested pack exists

Enables

agentskill

rotation mode in config.json

Maps the current session ID to the requested pack in .state.json

Returns immediate confirmation (zero tokens used)

When the hook blocks the message, Cursor keeps your cursor in the input field so you can type your next message right away.

The hook scripts (

scripts/hook-handle-use.sh

and

scripts/hook-handle-use.ps1

) do all the work - this SKILL.md file exists solely for discoverability in the

/

command autocomplete menu.

Usage

Users can invoke this by typing:

/peon-ping-use peasant

/peon-ping-use glados

/peon-ping-use sc_kerrigan

If the hook is not installed or fails, you can fallback to manual execution by following the instructions below.

Manual fallback (if hook fails)

If for some reason the hook doesn't intercept the command, follow these steps:

1. Parse the pack name

Extract the pack name from the user's request. Common pack names:

peon

— Warcraft Peon

glados

— Portal's GLaDOS

sc_kerrigan

— StarCraft Kerrigan

peasant

— Warcraft Peasant

hk47

— Star Wars HK-47

2. List available packs

Run this command to see installed packs:

bash

"

${CLAUDE_CONFIG_DIR

:-

$HOME

/

.claude}

"

/hooks/peon-ping/peon.sh packs list

Parse the output to verify the requested pack exists.

3. Get session ID

The session ID is available in the environment variable

CLAUDE_SESSION_ID

. Read it:

echo

"

$CLAUDE_SESSION_ID

"

If empty (Cursor users):

Use

"default"

as the key in

session_packs

. This applies the pack to all sessions without explicit assignment. Add

session_packs["default"] =

.

4. Update config to enable agentskill mode

Read the config file:

cat

"

${CLAUDE_CONFIG_DIR

:-

$HOME

/

.claude}

"

/hooks/peon-ping/config.json

Required:

Set

pack_rotation_mode

to

"agentskill"

. The pack must exist in the packs directory; if the assigned pack is missing or invalid, peon-ping falls back to

active_pack

and removes the stale assignment. The hook also adds the pack to

pack_rotation

(manual fallback can do the same).

Example config after setup:

"pack_rotation_mode"

:

"agentskill"

,

"pack_rotation"

:

[

"peasant"

,

"peon"

,

"ra2_kirov"

]

If

pack_rotation_mode

is

"random"

or

"round-robin"

, change it to

"agentskill"

. If the requested pack is not in

pack_rotation

, add it.

5. Update state to assign pack to this session

Read the state file:

cat

"

${CLAUDE_CONFIG_DIR

:-

$HOME

/

.claude}

"

/hooks/peon-ping/.state.json

Update the

session_packs

object to map this session to the requested pack. If

session_packs

doesn't exist, create it:

{

"session_packs"

:

{

"SESSION_ID_HERE"

:

"pack_name_here"

}

}

Use StrReplace or edit the JSON to add/update the entry:

If

session_packs

exists: add or update the session ID key

If

session_packs

doesn't exist: add it after the opening brace

6. Confirm to user

Report success with a message like:

Voice set to [PACK_NAME] for this session

Rotation mode: agentskill

Error handling

Pack not found

List available packs and ask user to choose one

No session ID

Inform user this feature requires Claude Code

File read/write errors

Report the error and suggest manual config editing Example interaction User: Use GLaDOS voice for this chat Assistant: [Lists packs to verify glados exists] Assistant: [Gets session ID] Assistant: [Updates config.json to set pack_rotation_mode: "agentskill"] Assistant: [Updates .state.json to set session_packs[session_id] = "glados"] Assistant: Voice set to GLaDOS for this session Rotation mode: agentskill Cursor compatibility note Cursor doesn't expose session IDs. Use session_packs["default"] instead: when doing the manual fallback, add "default": {"pack": "peasant", "last_used": 0} to session_packs . This applies the voice to sessions without explicit assignment (including Cursor chats). Reset to default To stop using a specific pack for this session, remove the session ID from session_packs in .state.json , or change pack_rotation_mode back to "random" or "round-robin" .