Agent skill · software engineering · dpearson2699
musickit
Integrate Apple Music playback, catalog search, and Now Playing metadata using MusicKit and MediaPlayer. Use when adding music search, Apple Music subscription flows, queue management, playback controls, remote command handling, or Now Playing info to iOS apps.
Why this skill is useful
Provides specific integration patterns and commands for managing Apple Music playback and catalog search that the AI wouldn't reliably generate on its own.
What it needs
Requires apple account access. About 5k tokens when loaded. Last updated 2026-07-31. 973 stars on the source repository.
What this skill does
MusicKit Search the Apple Music catalog, manage playback with ApplicationMusicPlayer, check subscriptions, and publish Now Playing metadata via MPNowPlayingInfoCenter and MPRemoteCommandCenter. Contents Setup Workflow Authorization Catalog Search Subscription Checks Playback with ApplicationMusicPlayer Queue Management Now Playing Info Remote Command Center Common Mistakes Review Checklist References Workflow 1. Verify the MusicKit App Service, bundle identifier, purpose string, and background-audio mode before debugging code. 2. Request authorization, then model every non-authorized state explicitly. 3. Search or load catalog content and check MusicSubscription.current before queueing playback. 4. Choose ApplicationMusicPlayer for app-scoped playback; wire Now Playing and remote commands only when the app owns those surfaces. 5. Test authorized, denied, unsubscribed, offline, queue failure, interruption, and track-change states. Fix the smallest failing layer, restore the fixture, and rerun the same state matrix. Setup Project Configuration 1. Enable the MusicKit App Service for the app's explicit bundle ID in the Apple Developer portal so MusicKit can generate developer tokens automatically. 2. Add NSAppleMusicUsageDescription to Info.plist explaining why the app accesses the user's media library. 3. For background playback, add the audio background mode to UIBackgroundModes. Imports Authorization Request permission before accessing the user's music data or playing Apple Music content. request() presents Apple's consent dialog when necessary; use currentStatus to read the current setting without prompting. Catalog Search Use MusicCatalogSearchRequest to search the Apple Music catalog. Catalog lookup can fetch Apple Music resources, but playback of subscription catalog content must still be gated on MusicSubscription.current.canPlayCatalogContent. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills dpearson2699/musickit