swiftui-agent-skill：给 Claude Code、Codex、Cursor 用的 SwiftUI 专家 skill 包

LLM 写 SwiftUI 经常会用它在训练数据里见过最多的 API——这通常意味着过时的导航路径、可访问性回退、以及看起来还行但编译出来很贵的动画模式。twostraws/swiftui-agent-skill（Hacking with Swift 的 Paul Hudson 出品）把"写现代、简洁、可访问 SwiftUI"的规则打包成一份 Agent Skill，可以塞进 Claude Code、Codex、Gemini、Cursor 或任何读 Agent Skills 格式的工具。

为什么这个 skill 重要

README 把这个 skill 定位为覆盖 navigation、layout、animations、state management、VoiceOver、deprecated APIs 以及"LLM 实际会犯的错"——VoiceOver 看不见的按钮、意外的 perf 成本、软废弃的 API 面。skill 设计成选择性触发器，可以限定审查范围（比如只查可访问性、或者只查性能），不必每次都跑全量。

姊妹 skill 覆盖邻近领域（SwiftData、Concurrency、Testing），但没有打包进这里。skill 用的是标准 Agent Skills 格式，可在 Claude Code、Codex、Gemini、Cursor 以及其他兼容工具之间移植。仓库 4.6k 星、166 fork、main 上 17 commits、8 open issues、3 open PR——仍在持续维护。License 是 MIT，贡献也必须是 MIT。

安装

标准 npx skills 安装覆盖大部分工具：

npx skills add https://github.com/twostraws/swiftui-agent-skill --skill swiftui-pro

Claude Code 走 marketplace 变体：

/plugin marketplace add twostraws/SwiftUI-Agent-Skill
/plugin install swiftui-pro@swiftui-agent-skill

安装器需要 Node。机器上没有就先装：

brew install node

Xcode 安装仓库链了一个 YouTube 演示（README 没把 Xcode 步骤写在正文里）。

真实工作流：发布前审一遍 SwiftUI 项目里的废弃 API

你马上要发一个 SwiftUI 应用，发布前想跑一次复查，挑出所有过时写法。skill 提供专门的选择性触发器，正好对应这个范围。

第一步。装好 skill 后，在项目根目录打开 Claude Code，跑：

/swiftui-pro Check for deprecated API

第二步。skill 被激活，扫描整个项目。它会标记软废弃的导航模式、编译代价高的动画 API，以及可访问性回退。

第三步。对每条发现，skill 产出修复片段。挑符合你意图的动手应用，大改之后重跑一次。

第四步。如果要聚焦某一范围，在前面加限定词。比如：

/swiftui-pro Focus on accessibility

skill 把审查缩到 VoiceOver label、点击区、Dynamic Type 行为。

第五步。发布后，如果希望 skill 在后续会话里默认生效，把它加进 AGENTS.md：

- Always consult: swiftui-pro

真实工作流：从 Codex 里用同一个 skill

你想在 Codex（而不是 Claude Code）里跑同样的审查。skill 同时支持两边。

第一步。在项目根目录的 Codex 会话里，按名字调用：

$swiftui-pro Focus on accessibility

第二步。Codex 用和 Claude Code 一样的方式加载 skill。产出也是同一种风格——VoiceOver label、点击区、Dynamic Type。

第三步。要让 skill 默认启用，把它加到 Codex 的配置里，对 SwiftUI 项目默认加载。

第四步。从 Claude Code（README 文档化的示例）里也可以用自然语言而非 slash 形式调用：

Use the SwiftUI Pro skill to look for performance problems in this project.

slash 调用最终路由到同一个 skill；自然语言调用在 Claude Code 里有文档，Codex 里 README 没明说，行为可能一致也可能不一致。

技巧

• 每次调用限定到一个范围（Focus on accessibility、Check for deprecated API），不要每次都跑全量——skill 的设计就是选择性触发。
• 每个 SwiftUI 项目默认都要审计的话，把 swiftui-pro 加进 AGENTS.md。
• skill 针对的是 LLM 特定问题，不是通用 SwiftUI 教学；它补充、不是替代 Apple 官方文档。
• 姊妹 skill 覆盖 SwiftData、Concurrency、Testing——这些栈的部分需要同样待遇时一起装。
• 贡献必须是 MIT，且应当针对边界情况和软废弃 API，不要重复 LLM 已经知道的东西。

何时不要用

如果你不在写 SwiftUI，这套完全不适用——skill 抓的 SwiftUI 问题也是 SwiftUI 特有的。如果你还在学 SwiftUI，skill 假设你已经会基础、只针对边界情况；先看 Apple 官方 SwiftUI 文档或 Hacking with Swift。如果你只想跑一次审查、不要默认生效，按需调用即可，不要把它写进 AGENTS.md。

在 leaderboard 查看更多 skill 包。