Skip to main content
skill CX Codex

visionos — Claude Code skill: spatial design and visionOS widgets

A skill for Claude Code and Cursor that brings spatial-design patterns for visionOS: layout ergonomics, eyes-and-hands input, motion comfort, and immersive environments.

MIT 202 installs ★ 905 updated 2026-07-24

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add rshankras/claude-code-apple-skills --skill visionos -a claude-code
Open on GitHub

What visionos does

The skill gives the agent two knowledge modules: spatial-design and widgets. The first covers layout ergonomics (60pt eye targets, dynamic scale), eyes-and-hands input, hover effects, immersion strategy, spatial audio, and video formats — including production budgets for immersive environments. The second handles widget mounting styles, glass and paper textures, proximity-aware layouts, and spatial widget families.

Allowed tools are limited to Read, Glob, and Grep, so the agent reads and advises without touching project files on its own. Routing is automatic: a widget question pulls widgets/SKILL.md; a layout or input question pulls spatial-design/SKILL.md along with its reference files.

Installation via npx skills add drops the skill file into the platform's directory — ~/.claude/skills/visionos/SKILL.md for Claude Code, .cursor/skills/visionos/SKILL.md for Cursor. GitHub Copilot uses gh skill install instead.

What it helps with

  • audit a visionOS window layout against eye-target size requirements
  • implement eyes-and-hands input with correct hover effects
  • pick a mounting style and texture for a visionOS widget
  • build a proximity-aware widget layout that adapts to viewer distance
  • plan an immersive environment within production resource budgets

Example prompts for the agent

  • Review the window layout for 60pt minimum eye targets on visionOS
  • Add a hover effect to this button for eyes-and-hands input on visionOS
  • Pick the right mounting style and glass texture for my visionOS widget

How to install visionos

1Skills CLI (Vercel)

npx skills add rshankras/claude-code-apple-skills --skill visionos -a claude-code

2Manually: put the files in place

~/.claude/skills/visionos/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/visionos/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about visionos

How do I install the visionos skill in Claude Code?

Run npx skills add rshankras/claude-code-apple-skills --skill visionos -a claude-code. The skill file lands at ~/.claude/skills/visionos/SKILL.md.

What does the visionos skill do?

It equips the agent with spatial-design and widget patterns for visionOS, covering layout ergonomics, eyes-and-hands input, motion comfort, immersive environments, and widget mounting styles and textures.

Can the visionos skill edit my project files?

No. Its allowed tools are Read, Glob, and Grep only, so it reads and analyses but never writes or modifies files unless you explicitly ask the agent to act on its guidance.

Source text

SKILL.md · MIT
---
name: visionos
description: visionOS skills — spatial design (layout ergonomics, eyes-and-hands input, motion comfort, immersion, environments) and widget patterns (mounting styles, glass/paper textures, proximity-aware layouts). Use when designing, building, or reviewing anything for visionOS.
allowed-tools: [Read, Glob, Grep]
last_verified: 2026-07-16
review_by: 2027-06-22
---

# visionOS Skills

Spatial-computing patterns for visionOS.

## When This Skill Activates

Use this skill when the user:
- Designs, builds, or reviews any **visionOS app, window, volume, or immersive space**
- Asks about **spatial layout, eye/hand input, hover effects, motion comfort, or environments**
- Builds or adapts **widgets for visionOS**
- Asks about **mounting styles**, glass/paper **textures**, or spatial widget families
- Needs **proximity-aware layouts**

## Available Skills

Paths are relative to THIS file's directory — skills run with cwd set to the
user's project, so resolve each path from this SKILL.md's own location.

| Skill | Read | Covers |
|-------|------|--------|
| spatial-design | `spatial-design/SKILL.md` | Layout ergonomics (60pt eye targets, dynamic scale), input, motion comfort, immersion strategy, spatial sound, video formats; `immersive-environments.md` for production budgets |
| widgets | `widgets/SKILL.md` | Mounting styles, glass/paper textures, proximity-aware layouts, spatial families |

## How to Route

1. Read `widgets/SKILL.md` (relative to this file) plus any reference files it lists.
2. Apply the guidance to the user's code.

© rshankras · MIT · rshankras/claude-code-apple-skills

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set23

The whole set →
monetization monetization is a Claude Code skill for choosing pricing models and setting up app monetization for iOS and macOS. It activates when planning revenue or checking whether an app is ready to charge. CX Codex +1 484installs growth A skill for indie Apple developers: metrics, press outreach, community and business ops. Useful once the app ships and growth stalls. CX Codex +1 452installs core-ml Guides Core ML, Vision, NaturalLanguage and Create ML work in iOS and macOS projects, from model integration to training a custom classifier. CX Codex +1 445installs swiftui swiftui is a Claude Code skill for diagnosing SwiftUI state and rendering issues. It also provides focused guidance on layouts, charts, text editing, toolbars, and WebKit. CX Codex +1 224installs performance performance diagnoses slow apps, hangs, and memory leaks using Instruments; spots unnecessary SwiftUI re-renders and view identity issues. CX Codex +1 212installs swiftdata A skill for designing hierarchical SwiftData models with class inheritance, polymorphic queries, and type safety. Guides you through inheritance patterns, type-based filtering, and inheritance-versus-enum decisions. CX Codex +1 204installs foundation Guides coding assistants on Foundation AttributedString patterns, styling runs, alignment, and SwiftUI text integration. CX Codex +1 202installs mapkit This skill guides agents through MapKit and GeoToolbox patterns for place data. Use it for geocoding or matching place identifiers across services. CX Codex +1 199installs

Project sponsors

Companies that keep this analytics open