Visionos Design Guidelines

Wraps Apple's official HIG for visionOS into Claude's context so you get platform-specific guidance when building spatial apps. Covers the tricky stuff like spatial layout rules (don't put UI behind users, respect the 30-degree comfort zone), eye and hand input patterns (60pt minimum targets for gaze, look-and-pinch as primary interaction), and window behaviors with the glass material system. Honestly most useful when you're new to spatial computing and need to avoid the common mistakes that cause neck strain or broken interactions. Triggers automatically when you mention visionOS, RealityKit, or spatial UI work.

skills.sh installs: 1K
GitHub stars: 639
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add ehmo/platform-design-skills --skill visionos-design-guidelines --agent claude-code

Installs into .claude/skills of the current project.

Files

visionOS Design Guidelines

Comprehensive design rules for Apple Vision Pro based on Apple Human Interface Guidelines. These rules ensure spatial computing apps are comfortable, intuitive, and consistent with platform conventions.

1. Spatial Layout [CRITICAL]

Spatial layout determines user comfort and usability. Poor placement causes neck strain, disorientation, or inaccessible content.

Rules

SL-01: Center content in the field of view. Place primary windows and content directly ahead of the user at eye level. The comfortable vertical viewing range is approximately 30 degrees above and below eye level. Content outside this range requires head movement and causes fatigue.

SL-02: Maintain comfortable distance. Position content at a natural distance from the user, typically 1-2 meters for windows. Content too close feels invasive; content too far is hard to read. The system default placement is approximately 1.5 meters. Respect this unless there is a strong reason to override.

SKILL.md on GitHub