Skill
verify
How to verify media.sh changes end-to-end on a real Mac — isolated data dir, real native build, and a controllable fake now-playing app (no dependency on the…
Automation
Skill
/volume
Show or set the Mac's system output volume (0-100). Use when the user asks how loud the volume is, wants it louder/quieter, sets a specific level, or asks to mute.
Install
$ npx -y skills add Bangs00/claude-media-control --skill volume --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
- Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
- You can call itInvoke it directly when you want it.
- Slash command
/volume
Context preview
The summary Claude sees to decide when to auto-load this skill.
Show or set the Mac's system output volume (0-100). Use when the user asks how loud the volume is, wants it louder/quieter, sets a specific level, or asks to mute.
SKILL.md
volume.SKILL.mdname: volume description: Show or set the Mac's system output volume (0-100). Use when the user asks how loud the volume is, wants it louder/quieter, sets a specific level, or asks to mute. argument-hint: [0-100] allowed-tools: Bash
Requested volume: $ARGUMENTS
1. Work out the target:
- no argument → just read the current volume
- a number 0-100 → set that level
- relative ("louder", "quieter", "볼륨 올려/내려", "a bit louder") → read the
current level first, then add/subtract 10 (clamp to [0, 100])
- "mute" → set 0; "unmute" without a remembered level → suggest 50
2. Run with Bash:
"${CLAUDE_PLUGIN_ROOT}/scripts/media.sh" volume # read
"${CLAUDE_PLUGIN_ROOT}/scripts/media.sh" volume <0-100> # set, then reads backThe command prints `{"volume":N,"muted":bool}`. Confirm in one short markdown line, e.g. `🔊 Volume **45%**` (append `*(muted)*` when `muted` is true). This is the system output volume — it does not change per-app sliders.
Tip: the statusline can show the volume as icon + level bar + percent (`🔉 ▄ 45%`) — check "Volume" in the `/media:statusline` Items tab, or place it anywhere with a numeric pattern (digit 3).
Ships withmedia
The current track, live in your Claude Code statusline — ticking every second, ⌘+clickable, styleable down to the bar characters: And whatever your Mac is playing — Spotify, Apple Music, a browser tab, VLC — you can control it from the chat too: "what song is
Get the whole plugin
Other skills on media.
Skill
artwork
Show the album artwork (cover art) of the currently playing track. Use when the user asks to see the album art, cover image, or artwork of what's playing.
Skill
config
Quick media settings — turn the now-playing statusline, the /media:now progress bar, or the playback history on/off, or reset the statusline to its default…
Skill
doctor
Diagnose the media plugin — native build, read/control paths, fallbacks, permissions — and suggest fixes. Use when media commands fail, return nothing, or the…
Skill
history
Show recently played tracks (a passive local playback log). Use when the user asks what played earlier, what song was on before, recently played music, or to…