avdlee/swiftui-agent-skill
Overview
This skill scans Apple's SwiftUI documentation via the Sosumi MCP to find deprecated APIs and update the SwiftUI Expert Skill's latest-apis reference with modern replacements. It automates discovery, validation of availability versions, and produces pull-ready changes that keep SwiftUI guidance current. Use it after new iOS/Xcode releases or when asked to refresh deprecated SwiftUI APIs.
How this skill works
The skill reads the existing latest-apis reference and a scan manifest that lists API areas, search queries, and WWDC sessions. It uses Sosumi MCP calls to search and fetch Apple docs and transcripts, detects deprecation notices and recommended replacements, and records the iOS version where each modern API became available. Finally, it formats entries into the exact markdown structure required and prepares a branch and commit ready for a pull request.
When to use it
- After an iOS or Xcode release that may introduce new deprecations
- When asked to "update latest APIs" or "refresh deprecated SwiftUI APIs"
- Before publishing SwiftUI best-practice guidance or teaching material
- If automated tests or linters flag deprecated APIs in codebases
- Prior to a major app refactor targeting newer iOS versions
Best practices
- Start by reading the current latest-apis reference and the scan manifest to avoid duplicates
- Batch related searches to reduce API calls and focus on new deprecations
- Always verify the Availability section in fetched docs for the exact iOS version
- Prefer direct Apple replacement guidance; if none exists, record deprecation without guessing a substitute
- Follow the established markdown entry format and update the Quick Lookup Table for easy scanning
Example use cases
- Scan WWDC sessions and updated docs after iOS 18 release to capture newly deprecated SwiftUI APIs
- Refresh guidance before releasing an app that targets iOS 17+ to ensure examples use modern APIs
- Audit a codebase for deprecated SwiftUI calls and produce a checklist of exact replacements and required minimum iOS versions
- Maintain the SwiftUI expert reference as part of a periodic documentation review process
FAQ
Sosumi MCP must be available and you need write access to update the latest-apis reference file.
What if a deprecated API has no direct replacement?
Record the deprecation and note that no direct replacement exists rather than suggesting an incorrect alternative; include availability details and any relevant migration notes.
2 skills
This skill scans SwiftUI documentation for deprecated APIs and updates latest-apis.md with modern replacements using the Sosumi MCP.
This skill helps you build, review, or improve SwiftUI code using state management, modern APIs, and performance best practices.
