Developers can prevent common AI coding errors in SwiftUI
When using AI tools like Claude Code or Codex to write SwiftUI code, buttons often disappear from VoiceOver or deprecated APIs are used. This repository is a set of rules designed to catch the mistakes AI actually makes. Installing it takes a few minutes and helps the AI write more modern and accessible code.
SwiftUI pitfalls AI misses
This skill is built on thousands of hours of learning and real project experience. It directly targets common AI errors such as button VoiceOver recognition failures, use of deprecated APIs, and unexpected performance issues. Based on existing AGENTS.md files, it allows years of practical knowledge to be quickly conveyed to coding agents. It uses the Agent Skills format to work with various tools including Claude Code, Codex, Gemini, and Cursor.
Installation and activation
If Node.js is installed, you can easily install it using the npx skills add command. During installation, you can choose specific agents or apply it at the project or global level. Claude Code users can also add the marketplace and install the plugin directly. If using Xcode, you can follow the installation process by referring to a YouTube tutorial.
How to invoke the skill
In Claude Code, run the skill with the /swiftui-pro command, and in Codex with $swiftui-pro. If you want to check only specific parts rather than a full review, you can input specific instructions like 'check deprecated APIs' or 'focus on accessibility'. You can also request the skill to work by typing a natural language sentence such as 'find performance issues in this project'.
Pre-use considerations
This skill is distributed under the MIT license, allowing commercial use and modification. However, since skill files incur token costs, you should avoid repeating content the LLM already knows. When contributing, respect the token budget and focus on edge cases or subtle deprecations. If Node.js is not installed, it must be installed via Homebrew, which is a mandatory requirement for the installation process.