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
npx skills add rshankras/claude-code-apple-skills --skill visionos -a claude-codeWhat 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
glasstexture for my visionOS widget
How to install visionos
1Skills CLI (Vercel)
npx skills add rshankras/claude-code-apple-skills --skill visionos -a claude-code2Manually: put the files in place
~/.claude/skills/visionos/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/visionos/
1Skills CLI (Vercel)
npx skills add rshankras/claude-code-apple-skills --skill visionos -a codex2Manually: put the files in place
.agents/skills/visionos/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add rshankras/claude-code-apple-skills --skill visionos -a cursor2Manually: put the files in place
.cursor/skills/visionos/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install rshankras/claude-code-apple-skills skills/visionos2Manually: put the files in place
.github/skills/visionos/SKILL.md1Skills CLI (Vercel)
npx skills add rshankras/claude-code-apple-skills --skill visionos -a gemini-cli2Platform CLI
gemini skills install https://github.com/rshankras/claude-code-apple-skills --path skills/visionosManually: put the files in place
.devin/skills/visionos/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add rshankras/claude-code-apple-skills --skill visionos -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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