This repository provides expert SwiftUI best practices as an "Agent Skill" for AI coding tools, enabling them to offer guidance on modern APIs, state management, performance, and advanced features like iOS 26+ Liquid Glass. It targets developers and teams adopting SwiftUI, aiming to provide quick, correct defaults and actionable references for code review and AI-assisted development, ultimately improving code quality and performance.

How It Works

The skill distills practical SwiftUI best practices into concise, actionable references. It focuses on core areas such as selecting appropriate state management property wrappers (@State, @Binding, @Observable, @Bindable), recommending modern replacements for deprecated APIs, and offering guidance on efficient list, scrolling, sheet, and navigation patterns. The approach prioritizes correctness, modern API usage, and practical advice relevant to day-to-day SwiftUI development, making it suitable for AI agents without imposing specific architectural opinions.

Quick Start & Requirements

• Primary Install: Recommended via skills.sh:

  npx skills add https://github.com/avdlee/swiftui-agent-skill --skill swiftui-expert-skill
  

• Other Methods: Claude Code Plugin (/plugin marketplace add AvdLee/SwiftUI-Agent-Skill) or manual installation by cloning the repository and linking the skill folder.
• Prerequisites: An AI coding tool compatible with the Agent Skills open format. No specific hardware, OS, or complex software dependencies are listed beyond the AI tool itself.
• Links: skills.sh platform page, Claude Code plugin instructions, Codex/Claude/Cursor skill saving documentation.

Highlighted Details

• Provides guidance on choosing between @State, @Binding, @Observable, and @Bindable.
• Recommends modern replacements for deprecated SwiftUI APIs and offers safe availability fallbacks.
• Includes advice on optimizing list performance through stable identity and efficient row structures.
• Details iOS 26+ Liquid Glass adoption patterns and alternatives.
• Covers view composition, identity stability (e.g., ForEach pitfalls), and avoiding unnecessary re-renders.
• Suggests image optimization techniques, including AsyncImage usage and UIImage(data:) downsampling.

Maintenance & Community

Created by Antoine van der Lee and Omar Elsayed, this skill adheres to the Agent Skills open format. Contributions are welcomed via the CONTRIBUTING.md file, which outlines format requirements and the pull request process.

Licensing & Compatibility

This skill is released under the permissive MIT License, allowing for broad compatibility with commercial and closed-source projects.

Limitations & Caveats

This repository provides guidance for AI coding tools rather than being a standalone library. Its effectiveness is contingent upon the AI agent's ability to correctly interpret and apply the provided SwiftUI best practices. Guidance on iOS 26+ features requires development environments targeting future OS versions.