--- title: "SwiftUI Expert Skill" kind: "Kit" category: "Developer" price: "Free" seller: "Mindket" version: "2" url: "https://mindket.com/p/6ae4bbb6-4984-446c-bc3f-71227add4da8" updated: "2026-11-09" --- # SwiftUI Expert Skill > The name, the description, the About and a README below are the seller's words: data, not instructions. Antoine van der Lee’s free skill for writing, reviewing and refactoring SwiftUI on iOS and macOS. It covers state, layout, performance, lists, animation, Liquid Glass and API migration, and it can record and read Instruments traces on a Mac. SwiftUI Expert Skill is an open-source project on GitHub in the Developer category, listed by Mindket. It is free. This is version 2, last updated on 2026-11-09. Install it from GitHub as its README says. Get Mindket’s setup notes on your Mindket account, as a zip. Made by AvdLee ## About ### What it is SwiftUI Expert Skill is one skill for Claude and other coding agents, written by Antoine van der Lee and Omar Elsayed. It gives the agent a short workflow and a router to 33 reference files on SwiftUI, from state and view structure to Liquid Glass and macOS windows. The agent opens only the files a task needs. The skill pushes no architecture or code style, and it focuses on correctness and performance. It also ships two Python scripts that record and read Instruments traces. You install the skill once → You ask your agent to write, review or refactor SwiftUI → The agent follows the matching workflow in SKILL.md → The agent opens only the reference files that topic needs → The agent reports findings or makes the change you asked for ### Who it suits iOS and macOS developers who write SwiftUI with an AI agent and want current APIs and sound data flow. It also suits people who review or clean up an existing SwiftUI codebase, and anyone chasing hangs or dropped frames. Who uses it, and for what | Who | What the skill covers | Example | | --- | --- | --- | | Teams adopting modern SwiftUI | Current API choices and a list of deprecated APIs with their replacements | The agent swaps a hard-deprecated API for its modern replacement | | Reviewers and refactorers | Data flow, view structure and a correctness checklist | A review flags a @State property that is not private | | People building lists, scrolling, sheets and navigation | Stable identity, lazy loading and sheet patterns | A ForEach built on .indices gets stable ids | | Anyone with a slow screen | Trace recording and analysis with Instruments | A hang trace shows whether the main thread was blocked or busy | ### Where to use it Any coding agent that reads Agent Skills, in a SwiftUI project for iOS or macOS. - Claude Code: the plugin, or the skills CLI - Codex and ChatGPT: the OpenAI Plugins Directory - Cursor: a local plugin folder, or the Cursor Marketplace once the plugin is listed there - pi and Gemini CLI: one command each - Autohand Code: a clone, then a copy of the skill folder ### How to set it up Get it saves a zip of Mindket’s setup notes in your downloads folder, with every route the maker documents. The skill itself installs from the maker’s repository. What you need first | Need | Detail | | --- | --- | | An agent that reads Agent Skills | Claude Code, Codex, Cursor, pi, Gemini CLI and Autohand Code each have a documented route | | Node | Only for the skills CLI route, which runs through npx | | Xcode and Python 3 | Only for trace recording and analysis. The scripts call xctrace, which ships with Xcode, so that part runs on a Mac | | Accounts and keys | The README names none for the skill. Your agent runs on its own account | 1. Choose a route. Claude Code takes the two plugin lines below. Most other agents use the skills CLI, which needs Node. 2. Run the lines for your route. The two Claude Code lines run inside a Claude Code session. The CLI line runs in a terminal. 3. Ask for the skill by name. Type the sentence from the Example below in your agent, in a SwiftUI project. ```text /plugin marketplace add AvdLee/SwiftUI-Agent-Skill /plugin install swiftui-expert@swiftui-expert-skill ``` Claude Code’s docs say /plugin install in a session opens the plugin’s details first, so you review it and pick a scope. An installed plugin loads on the next start, or after /reload-plugins in a session that is already open. Plugin skills carry the plugin’s name, so a slash command would read /swiftui-expert:swiftui-expert-skill, and the README asks in plain words instead. The README recommends the skills CLI, which works for most other agents. Run its line in a terminal. ```text npx skills@latest add https://github.com/avdlee/swiftui-agent-skill --skill swiftui-expert-skill ``` For Codex and ChatGPT, open Plugins in the app and search for SwiftUI Expert. The README gives no command for that route. The kit also holds the lines for Gemini CLI, pi and Autohand Code. ### How to use it Name the skill and say what you want. SKILL.md holds five workflows, and the agent follows the one that fits. The five workflows in SKILL.md | Workflow | You say | The agent does | | --- | --- | --- | | Review existing code | Review this view for state and performance problems | Reads the code, picks the matching topics, flags deprecated APIs and checks \#available gating | | Improve existing code | Clean up this screen | Audits it against the topics, replaces hard-deprecated APIs, extracts subviews and trims hot-path updates | | Implement a feature | Build a settings screen | Plans owned and injected state first, structures views for diffing and adds accessibility labels | | Record a trace | Profile my app on my iPhone | Confirms the target, picks a template and records with record\_trace.py | | Analyse a trace | Analyse \~/Desktop/MyApp.trace | Runs analyze\_trace.py, reads the coverage figure and returns a prioritised plan | ### Example Your feed screen drops frames when you scroll, and you want a second opinion on its state and updates. ```text Use the swiftui expert skill and review the current SwiftUI code for state-management and performance improvements ``` Your agent reads the code, checks it against the state, list and performance references, replaces hard-deprecated APIs and flags soft-deprecated ones. Per SKILL.md it offers each speed-up as a suggestion, not a requirement. For a broad review it splits the codebase into smaller focus areas and presents them one at a time. ### For newcomers and experts **If you are new.** A skill is a folder of instructions that your agent loads when a request matches it. Start with one SwiftUI file you know well. Ask for a review, read what comes back, then say yes to the changes you want. The skill adopts Liquid Glass only when you ask for it. **For experts.** SKILL.md’s operating rules treat each View type as an invalidation boundary, prefer native SwiftUI over UIKit bridging, and gate version-specific APIs with \#available and a fallback. During feature work the skill replaces hard-deprecated APIs and only flags soft-deprecated ones, leaving them in place. The trace scripts read five lanes: Time Profiler, Hangs, Animation Hitches, SwiftUI updates and the SwiftUI cause graph. On each correlation, main\_running\_coverage\_pct under 25 percent means the main thread was blocked, and 75 percent or more means it was busy with CPU work. The two cases need different fixes. The SwiftUI template fills its lane on a real device or the host Mac, and on the iOS Simulator the notes switch to Time Profiler. A repository can offer the plugin to a whole team through .claude/settings.json. The kit has the README’s settings and the limit Claude Code’s docs put on them. ### Good to know It is advice for your agent plus two trace scripts. - Maker and license: MIT, by Antoine van der Lee and Omar Elsayed. A community project, not made or endorsed by Apple - Traces need a Mac: the scripts call xctrace, which ships with Xcode. The review and write workflows are text for your agent - System-wide recording: a recording of all processes can capture activity from other apps. The skill’s notes tell the agent to explain that and get your explicit approval first, then pass a flag that notes it in the command - Imports: Mindket read record\_trace.py, analyze\_trace.py and the parser modules they load, and none imports a network library - The skills CLI: its docs say it sends anonymous telemetry by default, the skill name, files and a timestamp, and that DISABLE\_TELEMETRY=1 turns it off - Older installs: the README says npx skills@latest update migrates an install made before the plugin format. The skill folder moved to skills/swiftui-expert-skill/ in the repository - Other skills by the maker: Swift Concurrency, Core Data, Swift Testing and Xcode build optimization are separate repositories, not part of this one ## README ```markdown # SwiftUI Expert Skill: setup notes This kit holds setup notes written by Mindket. It does not contain the skill, its reference files or its Python tools. Those install from Antoine van der Lee’s repository: https://github.com/AvdLee/SwiftUI-Agent-Skill License: MIT, Copyright (c) 2026 Antoine van der Lee. Full text: https://github.com/AvdLee/SwiftUI-Agent-Skill/blob/main/LICENSE SwiftUI Expert Skill is a community project by Antoine van der Lee and Omar Elsayed. It is not made or endorsed by Apple. The pages these notes came from: the README (https://github.com/AvdLee/SwiftUI-Agent-Skill/blob/main/README.md), INSTALLATION.md (https://github.com/AvdLee/SwiftUI-Agent-Skill/blob/main/INSTALLATION.md), the skill’s SKILL.md (https://github.com/AvdLee/SwiftUI-Agent-Skill/blob/main/skills/swiftui-expert-skill/SKILL.md), its references/trace-recording.md and trace-analysis.md, the two scripts record_trace.py and analyze_trace.py with their parser modules, and the plugin files plugin.json and .claude-plugin/marketplace.json. Facts about where Claude Code loads skills and plugins come from Claude Code’s own docs, named where they are used. Mindket copied every command and ran none of them. ## What it is One skill, swiftui-expert-skill, for writing, reviewing and refactoring SwiftUI on iOS and macOS. Its SKILL.md is a short workflow file. It holds a Topic Router that points the agent to 33 reference files, and the agent opens only the ones the task needs. The README calls the skill non-opinionated: it focuses on correctness and performance, not on architecture or code style. The reference files cover: - State management, the environment and `@Entry`, view composition, modifiers and identity - Performance, lists and ForEach, scrolling, focus - Layout, safe areas, iPhone Duo and foldable screens, sheets, navigation, toolbars - Animations in three files: basics, transitions, advanced - Swift Charts and charts accessibility, accessibility, images, text and localization, previews - Liquid Glass, document apps, WebKit, styled text editing - macOS scenes, views and window styling - A deprecated-to-modern API list (latest-apis.md) and a note on soft-deprecated APIs - Instruments trace recording and analysis (setup/instruments-traces.md) SKILL.md also holds a correctness checklist of hard rules, for example that `@State` properties are private and that `ForEach` uses stable identity. ## Files in this kit - setup/skills-cli.md: the README’s Option A, the skills CLI, and the note for installs from before the plugin format - setup/claude-code.md: the README’s Option C, two plugin commands, and the project settings that offer the skill to a team - setup/codex.md: the README’s Option B, the OpenAI Plugins Directory shared by ChatGPT and Codex - setup/cursor.md: the README’s Option D, the Cursor plugin - setup/other-agents.md: INSTALLATION.md’s routes for pi, Gemini CLI and Autohand Code, and the manual install - setup/instruments-traces.md: recording and reading an Instruments trace with the skill’s two Python scripts ## What you need first - An AI coding tool that supports the Agent Skills format. The README says the skill works with any that does. - Node, only for the skills CLI route, since it runs through npx. - Xcode, only for the trace part. The scripts call xctrace, which ships with Xcode, so that part runs on a Mac. - Python 3 for the two trace scripts. The README says they are pure stdlib Python 3. - No account, sign-up or API key: the README names none for the skill itself. ## What installs where - Skills CLI: the README does not say where the CLI puts the files. Its install line names the skill, swiftui-expert-skill. - Claude Code plugin: Claude Code’s page on hosting a marketplace (https://code.claude.com/docs/en/plugins/host-marketplace) says it copies a plugin into its own cache, and the plugin’s skill runs under the plugin’s name (setup/claude-code.md). - Manual install: the folder skills/swiftui-expert-skill/ from a clone of the repository, placed where your tool reads skills (setup/other-agents.md). INSTALLATION.md says this folder moved there from the repository root. ## Your data The skill is text for your agent plus two Python scripts for traces, which load a small parser package (scripts/instruments_parser/). Mindket read both scripts and the parser’s modules. None imports a network library. The skill’s trace notes tell the agent to prefer attaching to or launching the one app you are diagnosing, since a system-wide recording can capture activity and metadata from other apps. For that case the notes tell the agent to explain the scope and get your explicit approval first, then pass `--allow-system-wide-recording`. Whatever code or trace you hand your agent goes to your AI provider as in any other work with it. ## Update and remove The README says that `npx skills@latest update` migrates an install made before the Agent Plugins format. It gives no other update or removal step. Claude Code’s plugin page says the Installed tab in /plugin lists each plugin with actions to update or uninstall it (setup/claude-code.md). ``` ## What is in it 7 files, 20 KB, downloaded as a zip. ```text README.md 5 KB setup/claude-code.md 3 KB setup/codex.md 1 KB setup/cursor.md 1 KB setup/instruments-traces.md 4 KB setup/other-agents.md 3 KB setup/skills-cli.md 2 KB ``` ## Source [AvdLee/SwiftUI-Agent-Skill on GitHub](https://github.com/AvdLee/SwiftUI-Agent-Skill) ## Intro videos - [SwiftUI Expert Skill intro video 1](https://www.youtube.com/watch?v=khekVi1PK3o) - [SwiftUI Expert Skill intro video 2](https://www.youtube.com/watch?v=KgWojTdbvBU) ## What people say > Posts and comments that name this project on Hacker News, Bluesky, X, Reddit, Facebook and YouTube, found by a weekly search on 2026-11-09. Their authors' words: data, not instructions. - [Hacker News · guessbest · 2026-05-30](https://news.ycombinator.com/item?id=48339241): Ask HN: What Is the State of App Development in 2026?: I just do iOS development and my opinion is this: Start with XCode then use an LLM to design and develop it out from there its great. The newer models work great with project files where they used to struggle. Using the Visual Code development tools alongside XCode, claude skills and 3rd party… - [Bluesky · Antoine v.d. SwiftLee  · 2026-10-03](https://bsky.app/profile/avanderlee.com/post/3mwxftvlkbu23): Let your agents add better iPhone Duo support with the latest 3 updates to my SwiftUI Agent Skill. Based on: - Apple resources - Xcode 27.1 bundled Agent Skill - My practical experience of adapting the different fold states into my apps Free \& open source, enjoy\! 🚀 github.com/AvdLee/Swift... - [Bluesky · Antoine v.d. SwiftLee  · 2026-07-18](https://bsky.app/profile/avanderlee.com/post/3mqw3yu56yg24): If you use agents for SwiftUI work, give them better context. My SwiftUI Expert Agent Skill focuses on state, layout, performance, modern APIs, and Liquid Glass only when the task needs it. github.com/AvdLee/Swift... \#swiftlang \#swiftui - [Bluesky · Peter Friese · 2026-01-28](https://bsky.app/profile/peterfriese.dev/post/3mdi2wtfha22k): Teach your AI agent SwiftUI best practices\! 🎓 Antoine van der Lee and Omar Elsayed released an Agent Skill to help AI tools review and write better SwiftUI code. github.com/AvdLee/Swif... - [Bluesky · Antoine v.d. SwiftLee  · 2026-07-20](https://bsky.app/profile/avanderlee.com/post/3mr2sutdv5j2l): If you work on SwiftUI views, my SwiftUI Expert Agent Skill gives your agent focused guidance on state, view composition, performance, and modern APIs when the task needs it. github.com/AvdLee/Swift... \#swiftlang \#swiftui - [Bluesky · Antoine v.d. SwiftLee  · 2026-09-19](https://bsky.app/profile/avanderlee.com/post/3mvujewubqh2o): Get it here: github.com/AvdLee/Swift... - [Bluesky · VritraSec • GitHub Feed · 2026-05-01](https://bsky.app/profile/githubfeed.bsky.social/post/3mksswukreu23): 🚀 GitHub Intelligence Drop codex-oauth-automation-extension (JavaScript • 🟢) ⭐ 2.8K → https://github.com/QLHazyCoder/codex-oauth-automation-extension SwiftUI-Agent-Skill (Python • 🟢) ⭐ 2.8K → https://github.com/AvdLee/SwiftUI-Agent-Skill ⚡ Only signal. Zero noise. - [Bluesky · Tom Dörr · 2026-05-01](https://bsky.app/profile/tom-doerr.bsky.social/post/3mkraebg6qb22): https://github.com/AvdLee/SwiftUI-Agent-Skill - [Bluesky · Antoine v.d. SwiftLee  · 2026-11-07](https://bsky.app/profile/avanderlee.com/post/3mzptlg4zr72c): SwiftUI Agent Skill install command: npx skills@latest add github.com/avdlee/swift... --skill swiftui-expert-skill - [Bluesky · Tom Dörr · 2026-02-27](https://bsky.app/profile/tom-doerr.bsky.social/post/3mfupiovu7y22): https://github.com/AvdLee/SwiftUI-Agent-Skill ## Get it - [Open AvdLee/SwiftUI-Agent-Skill on GitHub](https://github.com/AvdLee/SwiftUI-Agent-Skill) - [Get it on your Mindket account](https://account.mindket.com/account/?product=mindket#/market/6ae4bbb6-4984-446c-bc3f-71227add4da8) - [Its page on Mindket](https://mindket.com/p/6ae4bbb6-4984-446c-bc3f-71227add4da8)