abdullah4ai/media
swiftship/internal/skills/data/ui/media/SKILL.md
Comprehensive media patterns: video playback, audio/music players, HLS streaming, remote images, AVAudioSession, memory management. Use when implementing any media-related features.
$ install --global
skillsauthnpx skillsauth add abdullah4ai/apple-dev-docs mediaInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Mar 30, 2026, 5:12 AM36.7s7 files scanned
SKILL.md
- name:
- media
- description:
- Comprehensive media patterns: video playback, audio/music players, HLS streaming, remote images, AVAudioSession, memory management. Use when implementing any media-related features.
- tags:
- avplayer, avkit, video, audio, music, streaming, hls, asyncimage, kingfisher, media
Media
Networking Clarification
Media playback URLs are permitted. The forbidden-patterns networking ban targets REST API clients (URLSession data tasks, custom HTTP clients), not media playback. The following are allowed:
AVPlayerwith remote URLs (MP4, HLS.m3u8streams)AsyncImageloading remote image URLsKFImage(Kingfisher) loading and caching remote imagesURLSession.shared.download(from:)only for downloading media files to local storage
Do not use URLSession for REST API calls, JSON fetching, or custom networking — that ban still applies.
Decision Tree
Pick the right pattern based on what you're building:
| Building | Reference | Key API |
|----------|-----------|---------|
| Video player | video-playback | VideoPlayer, AVPlayer |
| HLS/live streaming | video-playback | AVPlayer + .m3u8 URL |
| Video feed (TikTok-style) | video-playback + media-memory-management | FeedPlayerCoordinator |
| Music/audio player | audio-playback + audio-session | AVAudioPlayer (local) or AVPlayer (streaming) |
| Podcast player | audio-playback + audio-session | AVPlayer + Now Playing + Remote Commands |
| Background audio | audio-session | .playback category + UIBackgroundModes |
| Image gallery/feed | remote-images | KFImage (Kingfisher) |
| Simple remote image | remote-images | AsyncImage |
| Sound effects | audio-playback | AVAudioPlayer with .ambient category |
| Sample content | sample-media-urls | Public URLs, local audio generation |
Platform Capabilities
| Feature | iOS | macOS | tvOS | watchOS | visionOS | |---------|-----|-------|------|---------|----------| | Video playback | VideoPlayer | AVPlayerView (NSViewRepresentable) | VideoPlayer | No | VideoPlayer | | Audio playback | AVAudioPlayer / AVPlayer | AVAudioPlayer / AVPlayer | AVAudioPlayer / AVPlayer | WKAudioFilePlayer | AVAudioPlayer / AVPlayer | | AVAudioSession | Yes | No (not needed) | Yes | Limited | Yes | | Background audio | Yes (UIBackgroundModes) | N/A | No | Limited | Yes | | Now Playing info | Yes | Yes | Limited | No | Yes | | Remote commands | Yes | Yes | Limited | No | Yes | | AsyncImage | Yes | Yes | Yes | Yes | Yes | | Kingfisher | Yes | Yes | Yes | No | Yes |
Recommended Packages
All already in the curated package registry — no new dependencies to add:
- Kingfisher — remote image loading with disk/memory caching, prefetch, placeholder, fade. Use for image feeds and galleries (20+ images).
- DSWaveformImage — audio waveform visualization. Use for voice memo or audio editing UIs.
- AudioKit — advanced audio synthesis and processing. Only use when the user specifically needs audio effects, synthesis, or real-time audio processing.
Required Info.plist Keys
For background audio playback, add to the target's info section in project.yml:
UIBackgroundModes: ["audio"]
No other Info.plist keys are needed for basic media playback.
Cross-References
- PhotosPicker — see the
cameraskill (not duplicated here) - Camera access — see the
cameraskill - MapKit / CoreLocation — see the
mapsskill (not duplicated here) - Image containment / clip patterns — see the
swiftuiskill - Haptic feedback on media controls — see the
hapticsskill
References
This skill includes the following reference documents (auto-loaded):
- video-playback — VideoPlayer, HLS streaming, custom controls, feed-style video, looping
- audio-playback — AVAudioPlayer (local), AVPlayer (streaming), Now Playing, remote commands, playlists
- audio-session — AVAudioSession categories, interruption handling, route changes, background audio
- remote-images — AsyncImage vs Kingfisher decision, image grids, feeds, prefetch, cache config
- sample-media-urls — Public video/HLS/image URLs and local audio generation with
say - media-memory-management — Player lifecycle, observer cleanup, KVO, feed coordinator, debug checklist
Related Skills
abdullah4ai/scenekit-game
testing
VerifiedTrustedCommunity
Use for 3D games: racing, 3D sports, board games, marble maze, tower defense, bowling. SceneKit + SceneView architecture, 3D scene hierarchy, physics, game loop, primitives, materials, cameras, particles, audio.
8SKILL.mdUpdated Jul 23, 2026
abdullah4ai/game-ui
documentation
VerifiedTrustedCommunity
Game UI patterns: SwiftUI HUD overlays on SpriteKit, menus (main/pause/game-over), virtual joystick/d-pad, score displays, health bars, tutorial onboarding.
8SKILL.mdUpdated Jul 23, 2026
abdullah4ai/game-assets
tools
VerifiedTrustedCommunity
Download free game sprites/textures/3D models and generate procedural assets. Covers nw_download_asset tool, texture factories, sprite atlas organization, 3D model loading, and programmatic asset creation.
8SKILL.mdUpdated Jul 23, 2026
abdullah4ai/spritekit-game
testing
VerifiedTrustedCommunity
Use for 2D games: arcade, puzzle, sports, ping pong, platformer, shooter, 2D racing. SpriteKit + SpriteView architecture, scene hierarchy, physics, game loop, audio, particles, game feel.
8SKILL.mdUpdated Mar 27, 2026