IvanCampos/agents / skills/apple-music-player
apple-music-player
VerifiedPlay 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).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 1.6 KB |
| agents/openai.yaml | config | 292 B |
| scripts/play_random_music.shexecutable | script | 3.7 KB |
SKILL.md
View on GitHub---
name: apple-music-player
description: 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).
---
# 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 `--foreground` to 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 `--foreground` only when needed.
## Workflow
1. Prefer using the script in `scripts/` rather than retyping AppleScript.
2. If no matches are found, surface the script's error message to the user.
3. 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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |