Agent skill
apple-music-player
Play random songs or specific tracks in Music.app from the local Music library. Use when a user asks to play a random song by artist, random track from an album, random track from a playlist, or a specific track by name (optionally with artist).
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/apple-music-player
SKILL.md
Apple Music Player
Overview
Play a random track from the Music app's local library by artist, album, or playlist, using a bundled script that wraps AppleScript and handles errors.
Quick Start
- Artist:
scripts/play_random_music.sh --artist "JAY-Z" - Album:
scripts/play_random_music.sh --album "TRON: Ares" - Playlist:
scripts/play_random_music.sh --playlist "My Favorites" - Track:
scripts/play_random_music.sh --track "Rock the Boat" --artist "XG" - Foreground (optional): append
--foregroundto bring Music to front.
Behavior Notes
- Operates on the local Music library only; it does not search Apple Music.
- Artist, album, and track matching use "contains" so partial names work.
- Playlist matching requires an exact playlist name.
- Performance path keeps Music in background by default; use
--foregroundonly when needed.
Workflow
- Prefer using the script in
scripts/rather than retyping AppleScript. - If no matches are found, surface the script's error message to the user.
- If the user needs Apple Music search/playback, ask them to add the album or track to the Library first.
Resources
scripts/
scripts/play_random_music.sh: performance-optimized AppleScript runner to play by artist/album/playlist/track with optional foreground activation.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?