SkillsAdd

smithery/tomkrikorian

visionos-widgetkit-developer

Build and debug WidgetKit widgets for Apple Vision Pro (visionOS), including mounting styles (elevated/recessed), textures (glass/paper), proximity-aware layouts via LevelOfDetail, interactive widgets with AppIntents, widget rendering modes (accented/fullColor), and timeline update troubleshooting.

Installation

$ npx skills add smithery/tomkrikorian --skill visionos-widgetkit-developer
View on skills.sh ↗ Website ↗

Summary

Build and debug WidgetKit widgets for Apple Vision Pro (visionOS), including mounting styles (elevated/recessed), textures (glass/paper), proximity-aware layouts via LevelOfDetail, interactive widgets with AppIntents, widget rendering modes (accented/fullColor), and timeline update troubleshooting. (visionOS widgets are pinned spatial objects, not watch complications.)

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

agent-browser Shared topics
vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, includ…

810.4K installs
azure-diagnostics Shared topics
microsoft/azure-skills

Debug Azure production issues on Azure using AppLens, Azure Monitor, resource health, and safe …

568.9K installs
azure-validate Shared topics
microsoft/azure-skills

Pre-deployment validation for Azure readiness. Run deep checks on configuration, infrastructure…

567.7K installs
supabase-postgres-best-practices Shared topics
supabase/agent-skills

Postgres best practices maintained by Supabase, for Postgres running anywhere. Load this skill …

391.6K installs
widgetkit Similar name
dpearson2699/swift-ios-skills

Implement, review, or improve WidgetKit widgets and controls.

3.4K installs
widgetkit Similar name
prisma-labs-dev/apple-skills

API reference: WidgetKit. Query for widget timelines, entries, providers, home/lock screen widg…

357 installs

Also in this package

Other skills from smithery/tomkrikorian.

npx skills add smithery/tomkrikorian
visionos-immersive-media-developer 0 tkr-skill-writer 0 spatial-swiftui-developer 0 shareplay-developer 0 shadergraph-editor 0 realitykit-visionos-developer 0 arkit-visionos-developer 0

Browse all from smithery/tomkrikorian

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 3,542 B
  • docs SUMMARY.md 253 B

History

  1. First recorded snapshot · 0 installs

SKILL.md

visionOS WidgetKit Developer

Quick Start

Treat visionOS widgets as spatial objects first, not as small 2D surfaces.

  1. Decide the platform and family scope first.
  2. Define both close and far layouts before polishing visuals.
  3. Treat timeline entries, shared storage, and App Intents as the integration

boundary; do not depend on live host-app state.

  1. Load only the reference files that match the current problem.

Load References When

Reference When to Use
[widget-overview.md](references/widget-overview.md) Overview, decision points, and a quick checklist for Vision Pro widgets.
[families-and-platforms.md](references/families-and-platforms.md) When choosing native visionOS families, compatible iOS families, or extra-large widget support.
[mounting-styles.md](references/mounting-styles.md) When deciding elevated vs recessed support and avoiding layout breakage.
[visionos-rendering-styles.md](references/visionos-rendering-styles.md) When checking official visionOS widget rendering modes, backgrounds, families, textures, and routing to shared button-shape policy.
[textures-and-rendering.md](references/textures-and-rendering.md) When choosing glass vs paper, and ensuring legibility in different render modes.
[proximity-levelofdetail.md](references/proximity-levelofdetail.md) When implementing near/far layouts using LevelOfDetail.
[interactive-widgets.md](references/interactive-widgets.md) When adding Button, Toggle, or AppIntent-driven interactions to a widget.
[debugging-and-updates.md](references/debugging-and-updates.md) When widgets don’t refresh, don’t appear, or appear stale or broken.
[widget-animation.md](references/widget-animation.md) When animating widget content using timeline entries and Canvas crossfade, tuning frame rate, or hitting bundle or computation budget limits.

Workflow

  1. Confirm the widget platform and family set.
  2. Choose mounting style, texture, and near/far layout strategy.
  3. Decide the data path: timeline-only, App Group/shared storage, background

URL session, or WidgetKit push notification.

  1. Add interaction only if the widget still stays glanceable.
  2. Verify timelines, reloads, rendering modes, and extension logs after the

structure is set.

Guardrails

  • Always consider .simplified for distance readability.
  • Use native visionOS families intentionally; extra-large native visionOS

widgets use .systemExtraLargePortrait, while compatible iOS/iPadOS widgets keep .systemExtraLarge.

  • Do not assume recessed mode works without explicit layout checks.
  • Avoid dense, low-contrast layouts.
  • Use Link or widgetURL(_:) for open-app navigation; reserve Button and

Toggle for real AppIntent actions.

  • Keep widget configurations per WidgetBundle within the practical limit.

Output Expectations

Provide:

  • the widget platform and family scope
  • which references were used
  • the chosen presentation strategy
  • the main rendering, interaction, or timeline constraint
  • the next validation step