Skip to content
OpenSmartRoute
Skillv1.0.0

game-sounds

Install, configure, and troubleshoot Citedy's game-sounds feedback audio for Claude Code and supported CLI environments. Use when a user wants coding-agent event sounds, sound-pack rotation, volume or

by akillness(0) 0 installs
Free
Sign in to install

Free account. Installing gives you the manifest plus copy-paste snippets.

See reviews

About

Imported from akillness/jeo-skills (.agent-skills/game-sounds/SKILL.md). Install upstream with npx skills add akillness/jeo-skills --skill game-sounds. Copyright stays with the author.

Game Sounds

When to use this skill

  • Install or verify @citedy/game-sounds.
  • Switch a sound pack, manage rotation, set volume, or toggle event categories.
  • Diagnose a silent hook or create a custom local pack.
  • Explain the difference between the standalone CLI and Claude Code hook integration.

Route game-production SFX design or asset generation to rfxgen, game-vfx, or an engine-specific audio skill. This skill is for developer-agent feedback sounds, not a game's runtime audio system.

Instructions

Step 1: Capture the operating mode

Identify:

  • host: Claude Code plugin, global npm CLI, or cloned plugin directory;
  • action: install, status, configure, test, or custom pack;
  • platform player: afplay on macOS; paplay, pw-play, or ffplay on Linux;
  • acceptable audio behavior: volume, enabled events, and whether random rotation is desired.

Step 2: Check before installing

bash .agent-skills/game-sounds/scripts/setup.sh --check

Prefer the official Claude marketplace path when the user is in Claude Code. Use npm for a global game-sounds CLI, or clone only when a local plugin directory is explicitly wanted.

bash .agent-skills/game-sounds/scripts/setup.sh --npm
bash .agent-skills/game-sounds/scripts/setup.sh --clone

Restart Claude Code after plugin installation or hook changes.

Step 3: Validate configuration before editing it

The upstream configuration has four fields: volume, active_pack, pack_rotation, and enabled_events.

python3 .agent-skills/game-sounds/scripts/validate_config.py /path/to/config.json

Require volume in [0.0, 1.0], safe pack names, a unique string rotation list, and booleans for all event toggles. Prefer the upstream CLI over direct JSON edits:

game-sounds status
game-sounds list
game-sounds switch starcraft
game-sounds rotation add zelda
game-sounds volume 0.3
game-sounds test task-complete

Step 4: Map hooks to observable events

The inspected upstream hook mapping is:

  • SessionStart → session-start
  • UserPromptSubmit → task-acknowledge
  • Stop → task-complete
  • PostToolUseFailure → error
  • Notification → permission

When a hook is silent, check config discovery, event enablement, pack/category files, executable permissions, and the platform audio player in that order.

Step 5: Add custom packs conservatively

Create one pack directory with event-category subdirectories. Use only audio the user owns or is licensed to distribute. The upstream repository is MIT for its software, but bundled sounds and recognizable game/media properties may carry separate rights; preserve upstream credits and do not represent the audio catalog as universally redistributable.

Step 6: Verify real playback

A status command only proves configuration. Run one explicit game-sounds test <category> and confirm audible output with the user. If the environment is headless or has no audio device, report that configuration passed but playback was not verified.

Examples

Set a quiet rotating pair

game-sounds rotation clear
game-sounds rotation add mario
game-sounds rotation add zelda
game-sounds volume 0.2
game-sounds status

Validate a cloned plugin config

python3 .agent-skills/game-sounds/scripts/validate_config.py \
  "$HOME/.claude/plugins/game-sounds/config.json" --json

Best practices

  1. Use the CLI for changes and the validator for diagnosis.
  2. Test one event explicitly after configuration.
  3. Keep volume low and allow event categories to be disabled.
  4. Do not install or play sounds without user consent in shared or accessibility-sensitive environments.
  5. Separate software licensing from the rights of bundled audio assets and trademarks.

References

  • references/upstream.md — current upstream package, commands, hook map, and platform notes.
  • Citedy/game-sounds

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml
targets:
  - https://api.opensmartroute.ai/api/v1/registry/akillness-jeo-skills-game-sounds/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

akillness-jeo-skills-game-sounds.ocm.jsonjson
{
  "ocm": "1",
  "id": "akillness-jeo-skills-game-sounds",
  "kind": "skill",
  "name": "game-sounds",
  "description": "Install, configure, and troubleshoot Citedy's game-sounds feedback audio for Claude Code and supported CLI environments. Use when a user wants coding-agent event sounds, sound-pack rotation, volume or event toggles, playback checks, custom packs, or the game-sounds CLI/plugin. Triggers on: game-sounds, coding sounds, Claude hook sounds, task-complete sound, sound pack rotation, or @citedy/game-sounds.",
  "publisher": "akillness",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "utilities",
      "developer-experience",
      "audio",
      "claude-code",
      "hooks",
      "sound-packs",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Install, configure, and troubleshoot Citedy's game-sounds feedback audio for Claude Code and supported CLI environments. Use when a user wants coding-agent event sounds, sound-pack rotation, volume or event toggles, playback checks, custom packs, or the game-sounds CLI/plugin. Triggers on: game-sounds, coding sounds, Claude hook sounds, task-complete sound, sound pack rotation, or @citedy/game-sounds."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/akillness/jeo-skills",
      "path": ".agent-skills/game-sounds/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/akillness/jeo-skills/blob/HEAD/.agent-skills/game-sounds/SKILL.md",
      "key": "akillness/jeo-skills/.agent-skills/game-sounds/SKILL.md"
    },
    "compatibility": "macOS, Linux, or Windows with Python 3 and a supported local audio player; Claude hooks require Claude Code",
    "allowed_tools": [
      "Bash",
      "Read",
      "Write",
      "Edit",
      "Glob",
      "Grep"
    ]
  },
  "instructions": "# Game Sounds\n\n## When to use this skill\n\n- Install or verify `@citedy/game-sounds`.\n- Switch a sound pack, manage rotation, set volume, or toggle event categories.\n- Diagnose a silent hook or create a custom local pack.\n- Explain the difference between the standalone CLI and Claude Code hook integration.\n\nRoute game-production SFX design or asset generation to `rfxgen`, `game-vfx`, or an engine-specific audio skill. This skill is for developer-agent feedback sounds, not a game's runtime audio system.\n\n## Instructions\n\n### Step 1: Capture the operating mode\n\nIdentify:\n\n- host: Claude Code plug",
  "cost": {
    "context_tokens": 988
  }
}

Fetch it by URL: GET /api/v1/registry/akillness-jeo-skills-game-sounds/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.