musickitlisted
Install: claude install-skill thienqo/ios-skills
# MusicKit
Access the Apple Music catalog, play tracks, query personal cloud libraries, and present subscription upsells using MusicKit. Targets Swift 6.4 / iOS 26+.
## Contents
- [Setup & Permissions](#setup--permissions)
- [Subscription Verification](#subscription-verification)
- [Catalog Search & Browse](#catalog-search--browse)
- [Audio Playback](#audio-playback)
- [Subscription Upsell](#subscription-upsell)
- [Common Mistakes](#common-mistakes)
- [Review Checklist](#review-checklist)
- [References](#references)
## Setup & Permissions
Add `NSAppleMusicUsageDescription` to Info.plist. Request user authorization:
```swift
import MusicKit
func requestMusicAccess() async -> MusicAuthorization.Status {
let status = await MusicAuthorization.request()
return status
}
```
## Subscription Verification
Check capabilities on `MusicSubscription.current` before offering catalog playback:
```swift
func verifySubscription() async -> Bool {
let sub = try? await MusicSubscription.current
return sub?.canPlayCatalogContent ?? false
}
```
## Catalog Search & Browse
Search Apple Music songs, albums, and artists:
```swift
func searchMusic(term: String) async throws -> MusicItemCollection<Song> {
var request = MusicCatalogSearchRequest(term: term, types: [Song.self])
request.limit = 20
let response = try await request.response()
return response.songs
}
func fetchCharts() async throws -> MusicItemCollection<Song> {
let request = MusicCatalogChart