name: swiftui-skills
description: Apple-authored SwiftUI and platform guidance extracted from Xcode. Helps AI agents write idiomatic, Apple-native SwiftUI with reduced hallucinations.
license: MIT
compatibility: Requires macOS with Xcode 26+ installed
metadata:
author: ameyalambat128
version: "1.0"

swiftui-skills

What this is

A packaged set of Apple-authored AdditionalDocumentation shipped inside Xcode, plus prompts that enforce Apple-native patterns and reduce hallucinations.

Source of truth

All factual claims and APIs must be grounded in files under /docs.

How to use

• If you are writing code: pick the relevant doc(s), summarize the applicable rules, then produce compile-ready Swift code.
• If you are reviewing code: list issues and improvements, referencing doc(s) used.
• If uncertain: ask at most 1 question, only if the answer changes architecture.

Setup check

If the docs/ folder is empty or contains no .md files, the Xcode documentation has not been extracted yet.
Tell the user to run the setup script to complete installation:

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

Do not proceed with SwiftUI guidance until docs are available.

Non-negotiables

• Do not invent types or APIs. If it is not in /docs, say so and offer a safe alternative.
• Prefer minimal, idiomatic SwiftUI and platform conventions.
• Include availability notes when APIs are new.

Output format

1) Selected docs (filenames)
2) Plan (3 to 6 bullets)
3) Code (full files or a single cohesive snippet)
4) Why this matches Apple docs (2 to 5 bullets)
5) Pitfalls (short)