What is the SwiftUI Expert skill?
SwiftUI Expert Skill is an open-source skill from AvdLee/SwiftUI-Agent-Skill. It routes an AI coding agent to about 30 reference files on SwiftUI topics, enforces a correctness checklist for state, identity, animation and availability, and offers workflows for review, improvement, new features and Instruments trace analysis.
It is an open-source skill that helps an AI coding agent write, review and improve SwiftUI. Its SKILL.md contains a Topic Router that sends the agent to about 30 reference files, so only the relevant guidance is loaded for a given task.
What changes in your agent's output
- State follows the checklist: @State properties are private.
- ForEach uses stable identity, and @Entry values have stable defaults.
- displayScale is read from the environment, and animations use
.animation(_:value:)with a value. - Newer APIs are gated with #available.
- Liquid Glass is applied only when you ask for it.
Workflows it includes
- Reviewing existing SwiftUI code.
- Improving existing code.
- Building a new feature.
- Recording an Instruments trace.
- Improving code from the findings of a trace.
It also covers iPhone Duo and foldable layouts, and it does not enforce a particular app architecture.
Who the skill is for
Best for
- iOS and macOS developers whose agent writes outdated or fragile SwiftUI.
- Teams that want review feedback tied to a written checklist.
- Developers chasing performance who want an agent to work from Instruments traces.
Not for
- Cross-platform React Native apps. See building-native-ui.
- Visual direction and Apple-style design language. See apple-design.
- Choosing screens and flows for a mobile product. See design-mobile-apps.
If you want SwiftUI components to start from, shipswift-mcp is a related MCP server.
How to install SwiftUI Expert Skill for AI Coding Agents
/plugin marketplace add AvdLee/SwiftUI-Agent-SkillAdd the marketplace
In Claude Code, run
/plugin marketplace add AvdLee/SwiftUI-Agent-Skill.Install the plugin
Run
/plugin install swiftui-expert@swiftui-expert-skill.Other agents
The README says it ships client manifests for Claude Code, Cursor, Codex and pi, and lists the plugins directory route for Codex and ChatGPT. Or run
git clone https://github.com/AvdLee/SwiftUI-Agent-Skill.gitand copy skills/swiftui-expert-skill into your agent's skills folder.Ask for a review
Open your Xcode project in the agent and try: review this view for SwiftUI correctness.
Check that it loaded
Ask the agent to review a SwiftUI view and check that it comments on private @State, ForEach identity and animation value usage from the checklist.
Key features
- Topic RouterSKILL.md routes the agent to about 30 reference files, so guidance loads by topic instead of all at once.
- Correctness checklistPrivate @State, stable ForEach identity, stable @Entry defaults, displayScale from the environment,
.animation(_:value:)with a value and #available gating. - Review workflowThe agent audits existing SwiftUI against the checklist and reports what it finds.
- Improve workflowThe agent changes existing code to follow the checklist and reference guidance.
- New feature workflowThe agent builds new SwiftUI features using the same references from the start.
- Instruments trace workflowThe skill includes steps for recording a trace and for improving code from what the trace shows.
- Liquid Glass on requestLiquid Glass guidance is applied only when you ask for it.
- Foldable layoutsThe skill covers iPhone Duo and foldable layout concerns.
- No imposed architectureIt does not force MVVM or any other app architecture on your project.
Frequently asked questions
What is the SwiftUI Expert skill?
It is an open-source skill from AvdLee/SwiftUI-Agent-Skill that teaches an AI coding agent to write and review SwiftUI. It combines a topic router, a correctness checklist and workflows for review, improvement, new features and Instruments traces.
How do I install it?
In Claude Code, add the marketplace with /plugin marketplace add AvdLee/SwiftUI-Agent-Skill and install swiftui-expert@swiftui-expert-skill. For other agents, clone the repository and copy skills/swiftui-expert-skill into your skills folder. Check the README for your agent's exact plugin flow.
Does it force an architecture?
No. The skill says it does not enforce an architecture, so it works with your existing structure instead of pushing the agent to restructure the app around one pattern such as MVVM.
Does it use Liquid Glass by default?
No. Liquid Glass guidance is applied only when you ask for it, so ordinary reviews and features are not changed to adopt the newest visual style without you choosing that.
Can it help with performance?
Yes. It includes a workflow for recording an Instruments trace and another for improving the code from what the trace shows, so the agent works from measurements instead of guessing at slow views.
How is it different from Apple design skills?
This skill is about code correctness and workflow. For visual language and interface direction, see apple-design, which focuses on how an Apple-style interface should look and feel rather than how the code is written.
Does it work for React Native?
No. It is specific to SwiftUI. For Expo and React Native screens use building-native-ui, which covers native-feeling interfaces in that stack with its own library and styling rules. This skill does not apply there.