/swiftui-skills

Agent skills for SwiftUI,grounded in the documentation Apple ships with Xcode.

SwiftUI Skills extracts Apple-authored documentation shipped inside Xcode and turns it into reusable skills that help AI agents write idiomatic, Apple-native SwiftUI.

Install SwiftUI Skills

Recommended

$ curl -fsSL https://swiftui-skills.ameyalambat.com/install | bash

Or use npx skills

$ npx skills add ameyalambat128/swiftui-skills

Choose Global or Project in the skills TUI, and keep Symlink (Recommended) selected.

Global install

$ ~/.agents/skills/swiftui-skills/setup.sh

Project-local install

$ ./.agents/skills/swiftui-skills/setup.sh
> /swiftui-skills

Local-first install. No telemetry. No Apple documentation redistributed.

Works with Claude Code, Cursor, Codex, OpenCode, Windsurf, Gemini CLI, and Antigravity.

View on GitHub

What is SwiftUI Skills?

SwiftUI is opinionated. Most AI agents do not know those opinions, so they default to generic patterns that feel wrong in real Apple-platform apps.

SwiftUI Skills is a collection of local skills built from Apple-authored documentation that ships inside Xcode.

These skills steer AI agents toward the same patterns Apple expects in real SwiftUI apps, which means more idiomatic code, fewer hallucinated APIs, and less cleanup after generation.

  • Uses Apple-written guidance extracted from your local Xcode
  • Improves SwiftUI output for coding agents across editors
  • Open source, local-first, and no telemetry by default

Why this exists

AI agents struggle with SwiftUI not because the models are weak but because SwiftUI encodes architectural and design decisions that are rarely written down in public documentation.

Apple already ships a stronger source of truth inside Xcode.

SwiftUI Skills makes that guidance usable without moving the docs off your machine.

What the skills cover

The current SwiftUI Skills package covers:

SwiftUI patterns and composition
App Intents and system integrations
AlarmKit integration
StoreKit updates
WebKit + SwiftUI integration
SwiftData inheritance
Swift Concurrency updates
Liquid Glass design (SwiftUI, UIKit, AppKit, WidgetKit)
Widgets for visionOS
Low-level Swift performance primitives

All content comes from Apple documentation included with Xcode.

How it works

SwiftUI Skills works by giving AI agents better context, not new models or proprietary hosted infrastructure.

1.

The installer extracts Apple documentation from your local Xcode install

2.

Skills define how agents should use that guidance during generation and refactoring

3.

Your AI agent uses the docs as a local source of truth when writing code

No Apple documentation is redistributed. Everything is extracted locally during setup.

Who this is for

  • iOS developers refactoring into SwiftUI
  • Teams using AI agents to write SwiftUI-heavy apps
  • People working with App Intents, StoreKit, Widgets, or visionOS
  • Anyone tired of fighting non-idiomatic AI-generated SwiftUI

Open source

SwiftUI Skills is open source.

The skill definitions, prompts, and installer are public. Apple documentation is extracted locally from Xcode and is never redistributed.

You can inspect the installer before running it.

GitHub repositoryIssues and contributions welcome

SwiftUI skills FAQ

A short reference for teams looking for SwiftUI Skills and a better setup for AI coding agents, including Claude Code and Cursor.

More context

If you want the backstory, install flow, and why these skills exist, there's a longer write-up on the blog.

Read the blog post

Status

Early and evolving. Expect the package to track new Apple platform guidance as Xcode changes.