Agent skill

Update Swiftui APIs

by AvdLee in AvdLee/SwiftUI-Agent-Skill

Scan Apple's SwiftUI documentation for deprecated APIs and update the SwiftUI Expert Skill with modern replacements.

MITAuto-check passedMobile

Install Update Swiftui APIs

skills CLI
$ npx skills add AvdLee/SwiftUI-Agent-Skill --skill update-swiftui-apis -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install AvdLee/SwiftUI-Agent-Skill update-swiftui-apis --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/AvdLee/SwiftUI-Agent-Skill.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/update-swiftui-apis .claude/skills/update-swiftui-apis && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
update-swiftui-apis
GitHub stars
3.7k
Token cost
~1.2k tokens
SKILL.md length
483 words
Files
2 (incl. references)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Scan Apple's SwiftUI documentation for deprecated APIs and update the SwiftUI Expert Skill with modern replacements.

  • Works in 6 steps: Understand current coverage → Load the scan manifest → Scan Apple documentation → …
  • Asked to update latest APIs
  • SKILL.md covers Prerequisites, Workflow, Sosumi MCP Tool Reference and Tips
  • Calls gh

What it does

Update Swiftui APIs is an agent skill from AvdLee/SwiftUI-Agent-Skill. 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.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/scan-manifest.md`).

It sits in Mobile, covering iOS development. It works with SwiftUI, iOS, Model Context Protocol and Xcode. The repository describes itself as: Add expert SwiftUI Best Practices guidance to your AI coding tool (Agent Skills open format). The licence is MIT.

When your agent uses it

  • Asked to update latest APIs
  • Refresh deprecated SwiftUI APIs
  • Check for new SwiftUI deprecations
  • Scan for API changes

Example prompts

  • “update latest APIs”
  • “refresh deprecated SwiftUI APIs”
  • “check for new SwiftUI deprecations”
  • “/update-swiftui-apis”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Understand current coverage
  2. Load the scan manifest
  3. Scan Apple documentation
  4. Compare and identify changes
  5. Update latest-apis.md
  6. Open a pull request

What it can do on your machine

Read from SKILL.md and the folder at commit 204dba7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • gh

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use gh, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Update Swiftui APIs loads about 1.2k tokens when it runs, and up to ~2.7k if it reads all its reference files. Until then it costs about 87 tokens; SKILL.md has 483 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~87
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from AvdLee/SwiftUI-Agent-Skill at commit 204dba7, republished under its MIT licence (© AvdLee). 483 words, ~1,154 tokens.

Download SKILL.mdSave it as .claude/skills/update-swiftui-apis/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
update-swiftui-apis
description
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

Systematically scan Apple's developer documentation via the Sosumi MCP, identify deprecated SwiftUI APIs and their modern replacements, and update skills/swiftui-expert-skill/references/latest-apis.md.

Prerequisites

  • Sosumi MCP must be enabled and available (provides searchAppleDocumentation, fetchAppleDocumentation, fetchAppleVideoTranscript, fetchExternalDocumentation)
  • Write access to this repository (or a fork)

Workflow

1. Understand current coverage

Read skills/swiftui-expert-skill/references/latest-apis.md to understand:

  • Which deprecated-to-modern transitions are already documented
  • The version segments in use (iOS 15+, 16+, 17+, 18+, 26+)
  • The Quick Lookup Table at the bottom
2. Load the scan manifest

Read references/scan-manifest.md (relative to this skill). It contains the categorized list of API areas, documentation paths, search queries, and WWDC video paths to scan.

3. Scan Apple documentation

For each category in the manifest:

  1. Call searchAppleDocumentation with the listed queries to discover relevant pages.
  2. Call fetchAppleDocumentation with specific documentation paths to get full API details.
  3. Look for deprecation notices, "Deprecated" labels, and "Use ... instead" guidance.
  4. Note the iOS version where the modern replacement became available.
  5. Optionally call fetchAppleVideoTranscript for WWDC sessions that announce API changes.

Batch related searches together for efficiency. Focus on finding new deprecations not yet in latest-apis.md.

4. Compare and identify changes

Compare findings against existing entries. Categorize results:

  • New deprecations: APIs not yet documented in latest-apis.md
  • Corrections: Existing entries that need updating (wrong version, better replacement available)
  • New version segments: If a new iOS version introduces deprecations, add a new section
5. Update latest-apis.md

Follow the established format exactly. Each entry must include:

Section placement -- place under the correct version segment:

  • "Always Use (iOS 15+)" for long-deprecated APIs
  • "When Targeting iOS 16+" / "17+" / "18+" / "26+" for version-gated changes

Entry format:

markdown
**Always use `modernAPI()` instead of `deprecatedAPI()`.**

\```swift
// Modern
View()
    .modernAPI()

// Deprecated
View()
    .deprecatedAPI()
\```

Quick Lookup Table -- add a row at the bottom of the file:

markdown
| `deprecatedAPI()` | `modernAPI()` | iOS XX+ |

Keep the attribution line at the top of the file:

Based on a comparison of Apple's documentation using the Sosumi MCP, we found the latest recommended APIs to use.

Show full SKILL.md (171 more words)Show less
6. Open a pull request
  1. Create a branch from main named update/latest-apis-YYYY-MM (use current year and month).
  2. Commit changes to skills/swiftui-expert-skill/references/latest-apis.md.
  3. Open a PR via gh pr create with:
    • Title: "Update latest SwiftUI APIs (Month Year)"
    • Body: Summary of new/changed entries, attribution to Sosumi MCP

Sosumi MCP Tool Reference

ToolParametersReturns
searchAppleDocumentationquery (string)JSON with results[] containing title, url, description, breadcrumbs, tags, type
fetchAppleDocumentationpath (string, e.g. /documentation/swiftui/view/foregroundstyle(_:))Markdown documentation content
fetchAppleVideoTranscriptpath (string, e.g. /videos/play/wwdc2025/10133)Markdown transcript
fetchExternalDocumentationurl (string, full https URL)Markdown documentation content

Tips

  • Start broad with searchAppleDocumentation queries, then drill into specific paths with fetchAppleDocumentation.
  • Apple's deprecation docs typically say "Deprecated" in the page and link to the replacement.
  • WWDC "What's new in SwiftUI" sessions are the best source for newly introduced replacements.
  • When unsure about the exact iOS version for a deprecation, verify by checking the "Availability" section in the fetched documentation.
  • If an API is deprecated but no direct replacement exists, note this rather than suggesting an incorrect alternative.

© AvdLee, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in .agents/skills/update-swiftui-apis of AvdLee/SwiftUI-Agent-Skill.

  • SKILL.md
  • references/scan-manifest.md

Open the folder on GitHubat commit 204dba7

Compare with similar skills

Update Swiftui APIs next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Update Swiftui APIs compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Update Swiftui APIs this skillAvdLee/SwiftUI-Agent-Skill3.7k—~1.2kAutomated safety check: PassMIT
Inspector MCP Consumeripedro/Inspector170—~926Automated safety check: PassMIT
iOS Simulator Skillconorluddy/ios-simulator-skill1.3k—~5.7kAutomated safety check: PassMIT
SwiftUI Design SkillWholiver/swiftui-design-skill213—~2.8kAutomated safety check: PassMIT
Swiftui Iphone DuoFloWritesCode/fwc-swiftui-skills388—~3.9kAutomated safety check: PassMIT
Inspector MCPipedro/Inspector170—~3.4kAutomated safety check: PassMIT

Similar skills

  • Inspector MCP Consumer

    ipedro/Inspector

    A skill your agent uses when an agent needs to patch a consumer iOS app so it exposes the Inspector MCP bridge, add or verify the app-side Inspector startup configuration, or choose the correct…

    170 GitHub stars~926 tokensUpdated 5 mo ago
    MobileAuto-check passed
  • iOS Simulator Skill

    conorluddy/ios-simulator-skill

    29 production-ready scripts for iOS app testing, building, and automation.

    1.3k GitHub stars~5.7k tokensUpdated 3 days ago
    MobileAuto-check passed
  • SwiftUI Design Skill

    Wholiver/swiftui-design-skill

    Guides the agent to design distinctive SwiftUI interfaces for iOS and macOS, with six anti-generic rules, a design direction workflow and a five-dimension review.

    213 GitHub stars~2.8k tokensUpdated 5 mo ago
    MobileAuto-check passed
  • Swiftui Iphone Duo

    FloWritesCode/fwc-swiftui-skills

    Adapts and reviews SwiftUI apps for iPhone Duo (Xcode 27.1 / iOS 27.1 SDK) and continuously changing window sizes.

    388 GitHub stars~3.9k tokensUpdated yesterday
    MobileAuto-check passed
  • Inspector MCP

    ipedro/Inspector

    A skill your agent uses when an agent needs to inspect a live iOS app through the Inspector MCP bridge, register or troubleshoot InspectorMCPServer for a consumer Xcode project, or query, resolve…

    170 GitHub stars~3.4k tokensUpdated 5 mo ago
    MobileAuto-check passed
  • Audit Xcode Security Settings

    superagents-lab/xcode27-skills

    Audit and enable security-oriented Xcode build settings. An agent skill from superagents-lab/xcode27-skills.

    339 GitHub stars~4.6k tokensUpdated 4 mo ago
    MobileAuto-check passed

Categories

Questions about Update Swiftui APIs

What does Update Swiftui APIs do?

Scan Apple's SwiftUI documentation for deprecated APIs and update the SwiftUI Expert Skill with modern replacements. Update Swiftui APIs is an agent skill from AvdLee/SwiftUI-Agent-Skill. Scan Apple's SwiftUI documentation for deprecated APIs and update the SwiftUI Expert Skill with modern replacements.

When should I use Update Swiftui APIs?

Update Swiftui APIs fits situations like: asked to update latest APIs; refresh deprecated SwiftUI APIs; check for new SwiftUI deprecations; scan for API changes.

How do I install Update Swiftui APIs in Claude Code?

Run `npx skills add AvdLee/SwiftUI-Agent-Skill --skill update-swiftui-apis -a claude-code`. Or copy the skill folder (.agents/skills/update-swiftui-apis in AvdLee/SwiftUI-Agent-Skill) into .claude/skills/update-swiftui-apis in your project. Claude Code loads it when a task matches its description.

How do I install Update Swiftui APIs in Codex?

Run `npx skills add AvdLee/SwiftUI-Agent-Skill --skill update-swiftui-apis -a codex`. Or copy the skill folder (.agents/skills/update-swiftui-apis in AvdLee/SwiftUI-Agent-Skill) into .agents/skills/update-swiftui-apis in your project. Codex loads it when a task matches its description.

Can I use Update Swiftui APIs in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add AvdLee/SwiftUI-Agent-Skill --skill update-swiftui-apis -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/update-swiftui-apis, .gemini/skills/update-swiftui-apis, .github/skills/update-swiftui-apis and .opencode/skills/update-swiftui-apis in your project.

What does Update Swiftui APIs need to run?

Going by SKILL.md and its folder, Update Swiftui APIs needs the command-line tools its instructions call (gh).

Does Update Swiftui APIs access the network?

SKILL.md contains no URLs. Its commands use gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Update Swiftui APIs safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Update Swiftui APIs use?

Update Swiftui APIs is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Update Swiftui APIs use?

About 1.2k tokens (SKILL.md is roughly 4.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.5k tokens, read only when the agent opens those files.

What are the alternatives to Update Swiftui APIs?

Skills that share tags, products or a category with Update Swiftui APIs: Inspector MCP Consumer (ipedro/Inspector, 170 stars), iOS Simulator Skill (conorluddy/ios-simulator-skill, 1.3k stars), SwiftUI Design Skill (Wholiver/swiftui-design-skill, 213 stars) and Swiftui Iphone Duo (FloWritesCode/fwc-swiftui-skills, 388 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Update Swiftui APIs?

AvdLee (a GitHub user) maintains it in AvdLee/SwiftUI-Agent-Skill, which has 3,668 GitHub stars. The repository was last updated on October 6, 2026.

Source: AvdLee/SwiftUI-Agent-Skill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.