Only the Liquid Glass subsection should have been removed (it
duplicates references/liquid-glass.md). The other iOS 26+ entries
(scroll edge effects, background extension, tab bar minimize) are
new API guidance and belong here.
- Re-add iOS 26+ to Table of Contents
- Replace Liquid Glass code examples with a link to liquid-glass.md
- Keep Scroll Edge Effects, Background Extension, Tab Bar subsections
- Move animation(_:value:) from iOS 17+ to Always Use section since
it back-deploys to iOS 13+
- Remove entire "When Targeting iOS 26+" section (Liquid Glass, scroll
edge effects, background extension, tab bar) since it duplicates
the existing references/liquid-glass.md and these are new APIs,
not deprecated-to-modern transitions
- Update Table of Contents and Quick Lookup Table accordingly
Adds a cross-IDE agent skill at .agents/skills/update-swiftui-apis/
that uses the Sosumi MCP to systematically scan Apple's documentation
for deprecated SwiftUI APIs and update the latest-apis.md reference.
Includes a categorized scan manifest covering navigation, appearance,
state management, gestures, animations, tabs, accessibility, Liquid
Glass, and WWDC session paths.
The @Observable and onChange checklist items are specific instances
already covered by "No deprecated modifiers used" + the required
latest-apis.md reference. Keeping them would imply they're more
important than the other 20+ transitions in the guide.
- Move @Entry macro to "Always Use" section: Apple docs confirm it
back-deploys to iOS 13+ (Xcode 16 macro, not iOS 18+ only)
- Remove GeometryReader from deprecated lookup table: it is not
deprecated, containerRelativeFrame/visualEffect are alternatives
for specific use cases, not replacements
- Reframe GeometryReader prose as a suggestion per AGENTS.md guidelines
Based on a comparison of Apple's documentation using the Sosumi MCP,
we found the latest recommended APIs to use. This adds a comprehensive
deprecated-to-modern API reference with 25+ transitions organized by
minimum deployment target (iOS 15+ through iOS 26+).
- Create references/latest-apis.md with version-segmented code examples
- Elevate latest-apis.md as required first step in all SKILL.md workflows
- Add Latest APIs review checklist section
- Delete modern-apis.md and text-formatting.md reference files
- Remove related sections from SKILL.md (modern API rules, checklist items, quick reference table)
- Clean up image-optimization.md, scroll-patterns.md, and layout-best-practices.md
- Update AGENTS.md, README.md, and plugin metadata to reflect removals
Credit the works that inspired and informed this skill's SwiftUI
guidelines: Paul Hudson's SwiftAgents, the Helm developers' AGENTS
file, and Thomas Ricouard's Skills collection.
Ensure the related skills section promotes the Swift Testing skill alongside the existing SwiftUI, Core Data, and Swift Concurrency links.
Co-authored-by: Cursor <cursoragent@cursor.com>
to resolve error when installing via Claude Code
Plugin Errors
└ 1 plugin error(s) detected:
└ swiftui-expert@swiftui-expert-skill: Plugin swiftui-expert has conflicting manifests: both plugin.json and marketplace entry specify
components. Set strict: true in marketplace entry or remove component specs from one location.
github-actions[bot]