Agent-Skills.md

Agent Skills: visionOS Immersive Media Developer

Implement immersive and spatial video experiences on Apple Vision Pro (visionOS), including RealityKit VideoPlayerComponent setup, portal/progressive/full immersive viewing modes, transitions and events, comfort mitigation, and Apple Immersive Video authoring workflows.

UncategorizedID: tomkrikorian/visionosagents/visionos-immersive-media-developer

Repository

tomkrikorian/visionosagents
tomkrikorianLicense: MIT
475

Install this agent skill to your local

pnpm dlx add-skill https://github.com/tomkrikorian/visionOSAgents/tree/HEAD/skills/visionos-immersive-media-developer

Skill Files

Browse the full folder contents for visionos-immersive-media-developer.

Download Skill

Loading file tree…

skills/visionos-immersive-media-developer/SKILL.md

Skill Metadata

Name
visionos-immersive-media-developer
Description
Implement immersive and spatial video experiences on Apple Vision Pro (visionOS 26), including AVKit AVExperienceController, RealityKit VideoPlayerComponent setup, Apple Projected Media Profile (APMP), portal/progressive/full immersive viewing modes, transitions and events, comfort mitigation, and Apple Immersive Video authoring workflows.

visionOS Immersive Media Developer

Quick Start

Decide first whether the app should use the system AVKit experience or a custom RealityKit playback surface.

  1. Clarify the media shape: surface video, portal, progressive immersive, full immersive, spatial video, or Apple Immersive Video.
  2. Load only the matching reference files.
  3. Treat playback-mode changes as both media and scene-orchestration work.

Load References When

| Reference | When to Use | |---|---| | playback-decision-tree.md | Decision tree: window vs portal vs progressive vs full immersive playback. | | avexperiencecontroller.md | When AVKit AVExperienceController is the right surface for the product. | | videoplayercomponent-basics.md | When you need to set up VideoPlayerComponent + AVPlayer correctly. | | apmp-and-spatial-video.md | When the content is spatial video, APMP, or Apple Immersive Video. | | immersive-viewing-modes.md | When implementing portal, progressive, or full modes and related scene transitions. | | events-and-transitions.md | When responding to VideoPlayerEvents and managing UI during transitions. | | comfort-mitigation.md | When handling comfort violations and mitigation strategies on visionOS 26+. | | apple-immersive-video-authoring.md | When you need Apple Immersive Video authoring or packaging references. |

Workflow

  1. Choose the playback architecture.
  2. Load the references for that surface and media type.
  3. Implement playback and viewing-mode transitions.
  4. Add event handling and comfort mitigation where relevant.
  5. Summarize the playback path, transition model, and remaining validation work.

Guardrails

  • Start with AVKit AVExperienceController when the system player experience fits the product.
  • Use RealityKit VideoPlayerComponent when the video must live in a custom scene graph.
  • Do not treat immersive-mode transitions as a simple property flip when the app also needs scene changes.
  • Make sure the user has a clear exit path from immersive playback.

Output Expectations

Provide:

  • the chosen playback architecture
  • the media type and viewing mode
  • which references were used
  • the transition or event model involved
  • the next validation step