SwiftUI Agent Skill for AI Coding Assistants

1<p align="center">
2    <img src="assets/logo.svg" alt="SwiftUI Pro - Agent Skill for Claude Code, Codex, and Gemini" height="100" />
3</p>
4 
5<h1 align="center">SwiftUI Agent Skill for AI Coding Assistants</h1>
6 
7<p align="center">
8    <img src="https://img.shields.io/badge/iOS-26+-2980b9.svg" alt="Designed for iOS 26 and later." />
9    <img src="https://img.shields.io/badge/swift-6.2+-8e44ad.svg" alt="Designed for Swift 6.2 and later." />
10    <a href="https://twitter.com/twostraws">
11        <img src="https://img.shields.io/badge/Contact-@twostraws-95a5a6.svg?style=flat" alt="Twitter: @twostraws" />
12    </a>
13</p>
14 
15An agent skill that helps AI coding assistants write smarter, simpler, and more modern SwiftUI, including guidance on API usage, design, performance, and accessibility. Covers navigation, layout, animations, state management, VoiceOver, deprecated API, and more, targeting the mistakes LLMs actually make.
16 
17Also available:
18 
19- [SwiftData Pro](https://github.com/twostraws/SwiftData-Agent-Skill)
20- [Swift Concurrency Pro](https://github.com/twostraws/Swift-Concurrency-Agent-Skill)
21- [Swift Testing Pro](https://github.com/twostraws/Swift-Testing-Agent-Skill)
22 
23Find more agent skills for Swift and Apple platform development at [Swift Agent Skills](https://github.com/twostraws/Swift-Agent-Skills).
24 
25The skill builds upon my existing [AGENTS.md](https://github.com/twostraws/SwiftAgents) file, meaning that you can bring years of knowledge and practical experience into your coding agent of choice in just a few minutes. It uses the [Agent Skills](https://agentskills.io/home) format, so it works smoothly with Claude Code, Codex, Gemini, Cursor, and more.
26 
27 
28## Installing SwiftUI Pro
29 
30You can install this skill into Claude Code, Codex, Gemini, Cursor, and more by using `npx`:
31 
32```bash
33npx skills add https://github.com/twostraws/swiftui-agent-skill --skill swiftui-pro
34```
35 
36If you get the error `npx: command not found`, it means you don’t currently have Node installed. You need to run this command to install Node through Homebrew:
37 
38```bash
39brew install node
40```
41 
42And if *that* fails it usually means you need to [install Homebrew](https://brew.sh) first.
43 
44When using `npx`, you can select exactly which agents you want to use during the installation. You can also select whether the skill should be installed just for one project, or whether it should be made available for all your projects.
45 
46Alternatively, you can clone this whole repository and install it however you want.
47 
48If you're using Xcode, watch the YouTube video on [How to Install and Use Agent Skills in Xcode](https://www.youtube.com/watch?v=nKVZBKoB6P4) for a walkthrough.
49 
50 
51## Using SwiftUI Pro
52 
53The skill is called SwiftUI Pro, and can be triggered in various ways. For example, in Claude Code you would use this:
54 
55> /swiftui-pro
56 
57And in Codex you would use this:
58 
59> $swiftui-pro
60 
61In both cases you can provide specific instructions if you want only a partial review. For example, `/swiftui-pro Check for deprecated API` on Claude, or `$swiftui-pro Focus on accessibility` in Codex.
62 
63You can also trigger the skill using natural language:
64 
65> Use the SwiftUI Pro skill to look for performance problems in this project.
66 
67 
68## Why Use an Agent Skill for SwiftUI?
69 
70This skill is built on thousands of hours of learning, experimenting, and building real-world SwiftUI projects. The rules contained here directly target common SwiftUI mistakes made by LLMs. They sometimes make buttons invisible to VoiceOver, they frequently use deprecated API, and they would often write code that causes surprise performance problems.
71 
72You can read more about why I created this skill in my article: [SwiftUI Agent Skill - Write better code with Claude, Codex, and other AI tools](https://www.hackingwithswift.com/articles/282/swiftui-agent-skill-claude-codex-ai).
73 
74 
75## Contributing
76 
77I welcome all contributions, whether that's adding new checks, improving existing checks, or editing this README – everyone is welcome!
78 
79- Keep your Markdown concise. There is a token cost to using skills, particularly with SKILL.md, so please respect the token budgets of users.
80- Do not repeat things that LLMs already know, because it burns tokens for no benefit. Focus on edge cases, surprises, soft deprecations, and similar.
81- All work must be licensed under the MIT license so it can benefit the most people.
82 
83Please ensure you abide by the [Code of Conduct](CODE_OF_CONDUCT.md).
84 
85 
86## License
87 
88SwiftUI Pro was originally created by [Paul Hudson](https://twitter.com/twostraws), who writes [free Swift tutorials over at Hacking with Swift](https://www.hackingwithswift.com). It’s available under the [MIT License](LICENSE), which permits commercial use, modification, distribution, and private use.
89 
90 
91<p align="center">
92    <a href="https://www.hackingwithswift.com/plus">
93    <img src="https://www.hackingwithswift.com/img/hws-plus-banner@2x.jpg" alt="Hacking with Swift+ logo" style="max-width: 100%;" /></a>
94</p>
95 
96<p align="center">&nbsp;</p>
97 
98<p align="center">
99    <a href="https://www.hackingwithswift.com"><img src="https://www.hackingwithswift.com/img/hws-button@2x.png" alt="Hacking with Swift logo" width="66" height="75" /></a><br />
100    A Hacking with Swift Project
101</p>
102