تسجيل الدخول
ameyalambat128

swiftui-skills

by @ameyalambat128 in AI & LLM
8
1
# Install this skill:
npx skills add ameyalambat128/swiftui-skills

Or install specific skill: npx add-skill https://github.com/ameyalambat128/swiftui-skills/tree/main/src/skill

# Description

Apple-authored SwiftUI and platform guidance extracted from Xcode. Helps AI agents write idiomatic, Apple-native SwiftUI with reduced hallucinations.

# SKILL.md

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)

# README.md

/swiftui-skills

Apple-authored SwiftUI and Apple platform guidance, packaged as skills for AI coding agents.

What is this?

SwiftUI is opinionated. Most AI agents don't know those opinions.

/swiftui-skills extracts internal Apple documentation shipped inside Xcode and turns it into reusable skills that help AI agents write idiomatic, Apple-native SwiftUI code.

  • Uses Apple-written guidance from inside Xcode
  • Reduces hallucinated or non-idiomatic SwiftUI
  • Works with Claude Code, Cursor, and similar tools
  • Open source and local-first

Installation

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

Using npx skills

npx skills add ameyalambat128/swiftui-skills
~/.agents/skills/swiftui-skills/setup.sh

The first command installs the skill. The second extracts Apple documentation from your local Xcode installation.

Requirements

  • macOS
  • Xcode 26 or later (the documentation lives inside Xcode)

Custom paths

If Xcode is installed in a non-standard location:

# Custom Xcode location
./install.sh --xcode-path /Applications/Xcode-beta.app

# Direct path to docs folder
./install.sh --docs-path /path/to/AdditionalDocumentation

How it works

  1. The installer extracts Apple documentation from your local Xcode install
  2. Skills define how agents should use that documentation
  3. Your AI agent uses the docs as source of truth when writing code

No Apple documentation is redistributed. Everything is extracted locally on install.

What's included

Documentation extracted from Xcode 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 (InlineArray, Span)

Usage

Claude Code

The installer automatically links the skill to ~/.claude/skills/. The skill is available immediately.

Cursor

Add the skill path to your Cursor configuration:

~/.swiftui-skills/

Project structure

swiftui-skills/
├── src/
│   ├── app/                    # Next.js website
│   ├── skill/                  # Skill package
│   │   ├── skill.md            # Agent contract
│   │   ├── manifest.json       # Tool compatibility
│   │   ├── prompts/            # System, router, reviewer, generator, refactorer
│   │   └── docs/               # Populated by installer
│   └── scripts/
│       ├── install.sh
│       └── uninstall.sh
└── public/
    └── install                 # curl target

Uninstall

~/.swiftui-skills/scripts/uninstall.sh

Who this is for

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

License

MIT

Author

Built by Ameya Lambat. Not affiliated with Apple.

# Related Skills

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

⚡ Amp 🚀 Antigravity 🤖 Claude Code 🦀 Clawdbot 📝 Codex ▶️ Cursor 🤖 Droid 💎 Gemini CLI 🐙 GitHub Copilot 🪿 Goose 📊 Kilo Code 🔧 Kiro CLI 💻 OpenCode 🦘 Roo Code 🌲 Trae 🏄 Windsurf

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.