update-swiftui-apis

An agent skill by AvdLee, from AvdLee/SwiftUI-Agent-Skill. Tags: development, documentation, ios, macos, migration, validation.

What it does

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.

Install

With the skills CLI, which installs into Claude Code, Codex, Cursor and other agents:

npx skills add AvdLee/SwiftUI-Agent-Skill --skill update-swiftui-apis

Or copy the skill folder into Claude Code's skills directory by hand (~/.claude/skills for every project, or .claude/skills inside one):

git clone --depth 1 https://github.com/AvdLee/SwiftUI-Agent-Skill
cp -r SwiftUI-Agent-Skill/.agents/skills/update-swiftui-apis ~/.claude/skills/update-swiftui-apis

Safety box score

Grade B, low risk: 18 of 100 risk points, rated 2026-10-16. The grade rates what the skill and its scripts can reach on the machine of whoever installs it, across eight categories from shell execution to secrets access. How the score works.

This skill scans Apple SwiftUI documentation through the Sosumi MCP, updates a markdown reference file in the repo, and then creates a GitHub pull request. The main risks are external network access to Apple/GitHub and autonomous publication of changes, though the write scope is otherwise narrow and file-only.

Category levels, from 0 (none) to 3 (high)
Category	Level	Why
Code & shell execution	0 (none)	No shell scripts or code evaluation are shipped in the skill; the workflow is plain markdown instructions plus MCP tool calls.
Network access	2 (moderate)	It explicitly calls remote tools like `searchAppleDocumentation`, `fetchAppleDocumentation`, `fetchAppleVideoTranscript`, and finishes with `gh pr create`, so data leaves the machine to Apple and GitHub.
Filesystem reach	1 (low)	The stated write target is scoped to `skills/swiftui-expert-skill/references/latest-apis.md`, with branch/commit changes kept inside the repository.
Secrets & credentials	0 (none)	The skill does not ask for passwords, API keys, `.env` files, or credential-store access; it only assumes the Sosumi MCP and GitHub auth are already available.
Privilege & persistence	0 (none)	There is no sudo, global install, service registration, or shell/OS setting change in the skill text.
Instruction hijack surface	0 (none)	The files do not instruct the agent to ignore higher-priority rules, hide actions, or follow untrusted remote instructions.
Irreversible actions	2 (moderate)	It directs the agent to create a branch, commit changes, and open a PR with `gh pr create`, which is an external side effect done without an explicit human review step.
Transparency	0 (none)	The skill files are readable markdown only; there are no binaries, encoded payloads, or downloaded installers.

Before installing

Confirm you want the agent to contact Apple docs services and GitHub during the run.
Inspect `references/scan-manifest.md` to see the exact documentation areas and WWDC sessions it will query.
Run it first in a fork or scratch branch if you do not want automatic PR creation in the main repo.

Rated 2026-10-16 by an automated review of 2 files from the skill's repository.

Source

Repository: AvdLee/SwiftUI-Agent-Skill (all skills from this repository)
Path: .agents/skills/update-swiftui-apis/SKILL.md
Branch: main
Updated: 2026-09-23

swiftui-expert-skill — Use when writing, reviewing, or refactoring SwiftUI code for iOS or macOS, including state and `@Observable` data flow, view composition, resizable layouts.
docs-cleaner — Consolidates redundant documentation while preserving all valuable content; keeps a doc set truthful after things change.
skill-reviewer — Reviews and improves Claude Code skills against official best practices.
app-platform-migration — Migrate applications from Heroku, AWS, Render, Railway, Fly.io, or Docker Compose to DigitalOcean App Platform. Use when converting existing apps.
expo-brownfield — Framework (OSS). Integrate Expo and React Native into an existing native iOS or Android app.
expo-dom — Framework (OSS). Use Expo DOM components to run web code in a webview on native and as-is on web. Migrate web code to native incrementally.