kienbui1995/magic-powers/visionos-patterns

Claude Code and agent skill by kienbui1995/magic-powers

Trust tier 2
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Use when designing for Apple visionOS, applying spatial design conventions, or building for the Apple Vision Pro platform

Install

npx vskill@latest install kienbui1995/magic-powers/visionos-patterns

SKILL.md

The same SKILL.md was published earlier as kienbui1995/magic-powers/visionos-patterns.

visionOS Design Patterns

When to Use

When building apps or experiences for Apple Vision Pro using visionOS.

Core Jobs

1. Window and Volume Types
TypeUse When
Window (2D)App that's a panel (productivity, media)
Volume (3D)App that places 3D objects in the world
Full Space (immersive)Experiences that take over the environment
Passthrough + SpaceMixed: real world + digital content

Start with Windows unless 3D is core to your experience. Full Space requires explicit user action to enter.

2. visionOS Interaction Model
  • Eyes: primary pointer (look at to select)
  • Hands: secondary (pinch to activate what eyes look at)
  • Voice: third modality (Siri integration)
  • Target affordance: elements must communicate they're interactive (hover effect via eye gaze)
  • Standard gestures: tap (index + thumb pinch), press (sustained pinch), drag (pinch + move)
3. visionOS HIG Key Principles
  • Passthrough integration: respect the real environment. Don't design as if user is in darkness.
  • Window anchoring: windows can be anchored to surfaces or float in space. Float is default.
  • Depth and layers: use SwiftUI's depth modifier to create z-axis separation
  • Materials: use vibrancy and glass materials — don't use flat opaque backgrounds
  • Ornaments: secondary controls that float beside the main window
4. RealityKit and SwiftUI Integration
  • UI layer: SwiftUI (same as iOS/iPadOS)
  • 3D content: RealityKit entities
  • Spatial audio: attach audio sources to 3D entities
  • Hand tracking: ARKit hand anchors for custom gesture recognition

Key Outputs

  • Window/volume/space type selection rationale
  • Interaction design spec (what gestures trigger what)
  • visionOS HIG compliance review
  • Material and depth specification

Anti-Patterns

  • iOS app ported to visionOS without redesign (violates HIG, feels unnatural)
  • Opaque flat backgrounds (use glass materials)
  • Tiny interaction targets (minimum 44pt x 44pt, larger for gaze-only)
  • Full Space for experiences that don't need it (jarring for users to enter)

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

Repository npm downloads, 7 days
24
7-day trend score
14

Downloads are for the repository's npm package. Refreshed 26 Apr 2026, 6 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/kienbui1995/magic-powers/visionos-patterns/badge)](https://verified-skill.com/skills/kienbui1995/magic-powers/visionos-patterns)

Something wrong with this skill or its page? Tell us.