SwiftUI Expert Skill
Expert guidance for any AI coding tool that supports the Agent Skills open format — SwiftUI state management, view composition, performance, and iOS 26+ Liquid Glass adoption.
This repository distills practical SwiftUI best practices into actionable, concise references for agents and code review workflows.
Who this is for
- Teams adopting modern SwiftUI APIs who want quick, correct defaults
- Developers reviewing or refactoring SwiftUI views and data flow
- Anyone shipping performant lists, scrolling, sheets, and navigation in SwiftUI
See also my other skills:
How to Use This Skill
Option A: Using skills.sh
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 performance improvements
Option B: Claude Code Plugin
Personal Usage
To install this Skill for your personal use in Claude Code:
- Add the marketplace:
/plugin marketplace add AvdLee/SwiftUI-Agent-Skill
- Install the Skill:
/plugin install swiftui-expert@swiftui-expert-skill
Option C: Cursor plugin
This repository is packaged as a Cursor plugin. See Cursor plugins documentation for installation instructions.
Project Configuration
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.
Option D: Codex / OpenAI-compatible tools
This repository includes an agents/openai.yaml manifest. Copy or symlink the swiftui-expert-skill/ folder into your Codex skills directory:
cp -R swiftui-expert-skill/ "$CODEX_HOME/skills/swiftui-expert-skill"
See Codex skills documentation for details on where to save skills.
Option E: Using pi package manager
Install via pi:
pi install https://github.com/AvdLee/SwiftUI-Agent-Skill
The skill will be available automatically in pi sessions.
Option F: Manual install
- Clone this repository.
- Install or symlink the
swiftui-expert-skill/ folder following your tool’s official skills installation docs (see links below).
- Use your AI tool as usual and ask it to use the “swiftui-expert” skill for SwiftUI tasks.
Where to Save Skills
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.
What's Inside
This skill covers the full surface of SwiftUI development -- from state management and view composition to Swift Charts, macOS multi-window scenes, animations, and iOS 26+ Liquid Glass -- without bloating your agent's task context. Reference files load on demand, so your agent gets deep guidance only for the topic at hand.
