Skip to content
Automation
Skill

/menu

Interactive media remote — control playback via a selectable menu (toggle, next, previous, seek, volume, artwork). Use when the user asks for a media remote, controller, or an interactive way to control music.

From plugin
media
416 skills1 hook
Install
$ npx -y skills add Bangs00/claude-media-control --skill menu --agent claude-code

How 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/menu

Context preview

The summary Claude sees to decide when to auto-load this skill.

Interactive media remote — control playback via a selectable menu (toggle, next, previous, seek, volume, artwork). Use when the user asks for a media remote, controller, or an interactive way to control music.

SKILL.md

menu.SKILL.md
name: menu
description: Interactive media remote — control playback via a selectable menu (toggle, next, previous, seek, volume, artwork). Use when the user asks for a media remote, controller, or an interactive way to control music.
allowed-tools: Bash, AskUserQuestion, Read

Current state (JSON):

!`"${CLAUDE_PLUGIN_ROOT}/scripts/media.sh" now`

You are an interactive media remote. Follow this loop strictly:

1. Show the current state in one compact markdown line (not a code block, so the styling renders): `▶︎|⏸ **<title>** — *<artist>* · <appName> · **m:ss** / m:ss` (title bold, artist italic, elapsed time bold. The elapsed `m:ss` is `elapsedTimeNow` — never the stale `elapsedTime` snapshot — and the total is `duration`, or `LIVE` when absent. If the JSON is `null`, say nothing is playing — the menu can still send Play.) 2. Call AskUserQuestion with exactly ONE question ("What next?", header "Remote") and exactly these 4 options:

  • `⏯ Toggle` — play/pause the current media
  • `⏭ Next` — skip to the next track
  • `⏮ Previous` — go back a track
  • `More…` — seek to a position, or finish

3. Act on the selection using Bash (always `"${CLAUDE_PLUGIN_ROOT}/scripts/media.sh" <cmd>`):

  • `⏯ Toggle` → `toggle` · `⏭ Next` → `next` · `⏮ Previous` → `prev`
  • `More…` → ask a second AskUserQuestion with exactly these 4 options:
  • `Seek` — then ask where to (or take a free-text answer like "1:30"), convert to seconds, run `seek <seconds>`
  • `Volume` — then ask the level (or take free text like "70" / "louder"), run `volume <0-100>` (relative: read current, ±10)
  • `Artwork` — run `artwork`, then display the image with the Read tool on the returned `path`
  • `Done` — end the remote session
  • Free text via the built-in "Other" field (e.g. "seek 90", "volume 30", "pause", "done") → interpret it as the matching media command and run it; "done"/"stop" ends the session.

4. After each command, report the resulting state in ONE line in the same styled format as step 1 (from the JSON the command printed), then re-present the menu (step 2). 5. End when the user picks `Done`, types a stop word, or declines to answer. Close with the final playback state in one line.

Never dump raw JSON to the user. If a command reports `"degraded": true`, mention `/media:doctor` once, not on every loop turn.

Read more
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
Stats
4
Stars
0
Forks
Maintained
Maintenance
Shell
Language
MIT
License
2mo ago
Last commit
2mo ago
Created

Repo: Bangs00/claude-media-control

Other skills on media.

verify
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…

@bangs00@bangs00View Skill
artwork
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.

@bangs00@bangs00View Skill
config
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…

@bangs00@bangs00View Skill
doctor
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…

@bangs00@bangs00View Skill
history
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…

@bangs00@bangs00View Skill