Write, review, or improve SwiftUI code following best practices for state management, view composition, performance, modern APIs, Swift concurrency, and iOS 26+ Liquid Glass adoption. Use when building new SwiftUI features, refactoring existing views, reviewing code quality, or adopting modern SwiftUI patterns.
Add this skill
npx mdskills install AvdLee/swiftui-expert-skillComprehensive SwiftUI guidance with clear workflows, modern API migration, and performance patterns
Expert guidance for any AI coding tool that supports the Agent Skills open format — modern SwiftUI APIs, state management, performance, and iOS 26+ Liquid Glass adoption.
This repository distills practical SwiftUI best practices into actionable, concise references for agents and code review workflows.
Install this skill with a single command:
npx skills add https://github.com/avdlee/swiftui-agent-skill --skill swiftui-expert-skill
For more information, visit the skills.sh platform page.
Then use the skill in your AI agent, for example:
Use the swiftui expert skill and review the current SwiftUI code for state-management and modern API improvements
To install this Skill for your personal use in Claude Code:
/plugin marketplace add AvdLee/SwiftUI-Agent-Skill
/plugin install swiftui-expert@swiftui-expert-skill
To automatically provide this Skill to everyone working in a repository, configure the repository's .claude/settings.json:
{
"enabledPlugins": {
"swiftui-expert@swiftui-expert-skill": true
},
"extraKnownMarketplaces": {
"swiftui-expert-skill": {
"source": {
"source": "github",
"repo": "AvdLee/SwiftUI-Agent-Skill"
}
}
}
}
When team members open the project, Claude Code will prompt them to install the Skill.
swiftui-expert-skill/ folder following your tool’s official skills installation docs (see links below).Follow your tool’s official documentation, here are a few popular ones:
How to verify:
Your agent should reference the workflow/checklists in swiftui-expert-skill/SKILL.md and jump into the relevant reference file for your task.
This skill gives your AI coding tool practical SwiftUI guidance. It can:
@State, @Binding, @Observable, @Bindable)ForEach pitfalls)UIImage(data:) is encountered (as an optional optimization)Non-Opinionated: Focuses on SwiftUI correctness and modern APIs, not forcing an architecture, project structure, or code style.
Modern-first: Calls out deprecated APIs and offers up-to-date replacements.
Practical & concise: Treats the agent as capable; provides the checklists and pitfalls that actually matter in day-to-day SwiftUI work.
swiftui-expert-skill/
SKILL.md
references/
animation-advanced.md - Performance, interpolation, and complex animation chains
animation-basics.md - Core animation concepts, implicit/explicit animations, timing
animation-transitions.md - View transitions, matchedGeometryEffect, and state changes
image-optimization.md - AsyncImage usage, downsampling, caching
layout-best-practices.md - Layout patterns and GeometryReader alternatives
liquid-glass.md - iOS 26+ glass effects and fallback patterns
list-patterns.md - ForEach identity and list performance
modern-apis.md - Deprecated API replacements
performance-patterns.md - Hot-path optimizations and update control
scroll-patterns.md - ScrollViewReader and programmatic scrolling
sheet-navigation-patterns.md - Sheets and type-safe navigation
state-management.md - Property wrapper selection and data flow
text-formatting.md - Modern Text formatting and string utilities
view-structure.md - View extraction and composition patterns
Contributions are welcome! This repository follows the Agent Skills open format, which has specific structural requirements.
Please read CONTRIBUTING.md for:
SKILL.md and the reference filesCreated by Antoine van der Lee and Omar Elsayed. With years of experience in Swift & SwiftUI, this skill distills practical knowledge into actionable guidance for AI assistants. Antoine published tens of articles on SwiftUI on his blog called SwiftLee.
This skill is open-source and available under the MIT License. See LICENSE for details.
Best experience: Claude Code
/plugin marketplace add AvdLee/swiftui-expert-skillThen /plugin menu → select skill → restart. Use /skill-name:init for first-time setup.
Other platforms
Install via CLI
npx mdskills install AvdLee/swiftui-expert-skillSwiftui Expert Skill is a free, open-source AI agent skill. Write, review, or improve SwiftUI code following best practices for state management, view composition, performance, modern APIs, Swift concurrency, and iOS 26+ Liquid Glass adoption. Use when building new SwiftUI features, refactoring existing views, reviewing code quality, or adopting modern SwiftUI patterns.
Install Swiftui Expert Skill with a single command:
npx mdskills install AvdLee/swiftui-expert-skillThis downloads the skill files into your project and your AI agent picks them up automatically.
Swiftui Expert Skill works with Claude Code, Claude Desktop, Cursor, Vscode Copilot, Windsurf, Continue Dev, Codex, Gemini Cli, Amp, Roo Code, Goose, Opencode, Trae, Qodo, Command Code. Skills use the open SKILL.md format which is compatible with any AI coding agent that reads markdown instructions.