Scan Apple's SwiftUI documentation for deprecated APIs and update the SwiftUI Expert Skill with modern replacements. Use when asked to "update latest APIs", "refresh deprecated SwiftUI APIs", "check for new SwiftUI deprecations", "scan for API changes", or after a new iOS/Xcode release. Requires the Sosumi MCP to be available.
update-swiftui-apis is a maintenance skill that keeps a SwiftUI expert knowledge base current by scanning Apple's developer documentation for deprecated SwiftUI APIs and their modern replacements. It solves the problem of SwiftUI reference material drifting out of date after each new iOS or Xcode release, when older APIs are deprecated and newer, version-gated replacements appear. The skill systematically discovers these changes and updates the reference file that documents recommended modern APIs.
The workflow first reads the existing latest-apis reference to understand current coverage and version segments (iOS 15 through 26), then loads a scan manifest that categorizes API areas -- navigation, styling, state management, presentation, text input, layout, gestures, accessibility, animations, tabs, previews, Liquid Glass, and scroll/lists -- along with search queries, documentation paths, and relevant WWDC session transcripts. Using the Sosumi MCP tools (searchAppleDocumentation, fetchAppleDocumentation, fetchAppleVideoTranscript, and fetchExternalDocumentation), it discovers pages, reads full API details, looks for deprecation notices and "use instead" guidance, and records the iOS version where each modern replacement became available. It then categorizes findings as new deprecations, corrections, or new version segments, updates the reference file following a strict entry format and quick-lookup table, and opens a pull request on a dated branch via the GitHub CLI with an attribution to the Sosumi MCP.
It targets iOS and SwiftUI developers and skill maintainers who want an evidence-based, documentation-driven way to refresh API guidance after Apple releases. Its explicit prerequisites are that the Sosumi MCP is enabled and available and that the user has write access to the repository or a fork.
The Sosumi MCP must be enabled and available, since it provides the searchAppleDocumentation, fetchAppleDocumentation, fetchAppleVideoTranscript, and fetchExternalDocumentation tools the skill relies on. Write access to the repository or a fork is also needed to commit updates and open a PR.
When asked to update the latest APIs, refresh deprecated SwiftUI APIs, check for new deprecations, or scan for API changes, and especially after a new iOS or Xcode release introduces or deprecates SwiftUI APIs.
It loads a scan manifest that lists categorized API areas with specific search queries, documentation paths, and WWDC session paths, covering areas from navigation and state management to gestures, accessibility, and the iOS 26 Liquid Glass APIs.
It updates the swiftui-expert-skill latest-apis reference file following an exact entry format and quick-lookup table, then creates a dated branch and opens a pull request via the GitHub CLI with a summary of new or changed entries and attribution to the Sosumi MCP.
It looks for deprecation labels and replacement guidance in the fetched documentation and verifies the exact iOS version by checking the Availability section of the fetched page, using WWDC 'What's new in SwiftUI' transcripts as a source for newly introduced replacements.
Quick Setup:
.claude/skills/Repository
avdlee/swiftui-agent-skill