ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified media Safety 4/5

apple-music-dj

Ultimate personalization engine for Apple Music. Analyzes listening history, Apple Music Replay stats, library data, and taste patterns to create intelligent playlists directly in the user's Apple Music library via the MusicKit API. Supports deep cuts discovery, mood/activity playlists, trend scouting, constellation discovery ("surprise me"), playlist refresh/evolution, automated weekly curation via cron, taste DNA cards, compatibility scoring, listening insights, catalog gap analysis, album deep dives, artist rabbit holes, daily song drops, concert prep, and personalized new release radar. Use this skill whenever the user mentions Apple Music, playlists, music recommendations, listening habits, music taste, "what should I listen to", discovering new music, mood playlists, workout playlists, deep cuts, hidden gems, trending music, "surprise me", refreshing a playlist, or anything related to curating their music experience. Also trigger on: "DJ", "mix", "playlist for", "music for", "songs like", "similar to", "what's hot", "new releases for me", "taste DNA", "taste card", "compatibility", "how compatible", "year in review", "listening stats", "what have I missed", "album deep dive", "rabbit hole", "concert prep", "seeing [artist] live", "daily song", "what should I listen to right now", or OpenClaw in the context of music.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/and3rn3t/apple-music-dj
Or

What This Skill Does

Apple Music DJ is a sophisticated personalization engine designed to transform your Apple Music experience. By bridging the gap between your raw listening history and intelligent, curation-ready data, this skill acts as a personal music consultant. It analyzes your habits, Apple Music Replay statistics, library ratings, and long-term taste patterns to build a unique 'Taste DNA' profile. Beyond simple sorting, the skill uses advanced strategies to create, refresh, and evolve your library. Whether you are looking for deep cuts that align with your obscure favorites, a mood-based playlist for a workout, or a comprehensive deep dive into an artist's discography, the DJ handles the heavy lifting via the MusicKit API.

Installation

To integrate this skill, ensure you have the OpenClaw environment configured. Run the following command in your terminal: clawhub install openclaw/skills/skills/and3rn3t/apple-music-dj. Once installed, you must configure two mandatory environment variables: APPLE_MUSIC_DEV_TOKEN and APPLE_MUSIC_USER_TOKEN. If you are missing these credentials, consult references/auth-setup.md for instructions on how to generate a JWT via the Apple Developer portal and authorize your session. You can verify your connection by running scripts/apple_music_api.sh verify.

Use Cases

This skill is perfect for music enthusiasts who feel overwhelmed by the sheer volume of available content. It excels at:

  • Discovery: Finding hidden gems through 'constellation' algorithms.
  • Maintenance: Automatically refreshing stale playlists to keep the music feeling fresh.
  • Analytics: Providing insight into your listening habits and catalog gaps.
  • Planning: Preparing for concerts by creating custom setlist-inspired playlists.
  • New Music: Generating personalized radar reports to ensure you never miss a release from artists you love.

Example Prompts

  1. "OpenClaw, create a high-energy, tempo-synced workout playlist using songs similar to my top 20 artists from this year."
  2. "I'm seeing Radiohead live next month—can you build a playlist of their best deep cuts and concert staples to get me ready?"
  3. "Surprise me with a new playlist that explores a genre I've never listened to but fits my overall taste profile."

Tips & Limitations

  • Force Refresh: If your taste profile feels outdated after a major listening binge, use the --max-age 0 flag with the taste profiler to force an immediate update.
  • Data Integrity: The skill relies heavily on the loved and hated tags in your library; ensuring these are up-to-date will significantly improve the accuracy of the compatibility scoring.
  • Rate Limiting: Note that frequent, automated API calls may be subject to Apple Music's rate limits. Keep cron-based curation frequencies to a reasonable daily cadence.

Metadata

Author@and3rn3t
Stars4473
Views3
Updated2026-05-01
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-and3rn3t-apple-music-dj": {
      "enabled": true,
      "auto_update": true
    }
  }
}

Tags

#music#apple-music#playlists#personalization#musickit#discovery
Safety Score: 4/5

Flags: network-access, file-read, file-write, external-api