AvdLee/SwiftUI-Agent-Skill

Add expert SwiftUI Best Practices guidance to your AI coding tool (Agent Skills open format).

What it solves

This project provides a specialized knowledge base and toolset for AI coding assistants to help developers build high-performance, modern SwiftUI applications. It prevents AI agents from providing outdated or inefficient SwiftUI code by providing them with concise, actionable references on state management, view composition, and the latest iOS APIs (including iOS 26+ Liquid Glass).

How it works

The project is packaged as an "Agent Skill" using an open format compatible with tools like Claude Code, Cursor, and ChatGPT. It consists of a library of Markdown reference files that the AI agent loads on demand to avoid bloating the context window. Additionally, it includes a Python-based toolchain that wraps xctrace to allow AI agents to record and analyze Instruments traces, helping them diagnose performance issues like hangs and hitches directly from trace data.

Who it’s for

  • Developers and teams using SwiftUI who want to ensure their AI coding tools follow modern best practices.
  • iOS/macOS developers who need to profile and analyze app performance using Instruments via an AI agent.
  • Developers refactoring legacy SwiftUI code to modern APIs.

Highlights

  • On-demand Reference Library: Covers everything from @Observable and NavigationStack to Swift Charts and accessibility.
  • Automated Performance Analysis: Includes scripts to record and parse xctrace files, allowing agents to identify if a hang is CPU-bound or blocked by I/O.
  • Broad Tool Compatibility: Supports multiple AI clients including Claude Code, Cursor, Codex, and ChatGPT.
  • Modern API Coverage: Includes specific guidance for iOS 26+ Liquid Glass and migration guides from iOS 15+.

Related

  • Project
    AvdLee/Swift-Testing-Agent-Skill

    A specialized knowledge base for AI coding agents that provides expert guidance on modern Swift Testing APIs, XCTest migration, and parallel test execution.

  • Project
    AvdLee/Xcode-Build-Optimization-Agent-Skill

    A collection of AI agent skills for benchmarking and optimizing Xcode build performance, providing an automated analyze-approve-fix workflow to reduce build times.

  • Project
    AvdLee/Swift-Concurrency-Agent-Skill

    A portable agent plugin that provides AI coding tools with expert guidance on Swift Concurrency for safe coding, performance optimization, and Swift 6 migration.

  • Project
    AvdLee/Core-Data-Agent-Skill

    A specialized knowledge set for AI coding agents that provides expert guidance on Core Data persistence, performance optimization, and schema migration for Apple platforms.

  • Project
    KKKKhazix/khazix-skills

    A collection of standardized AI agent skills (instruction sets) for goal definition, disk cleanup, deep research, and project documentation maintenance.