Skip to content

Add maintenance skill to update SwiftUI API deprecations#29

Merged
AvdLee merged 1 commit intomainfrom
feature/update-swiftui-apis-skill
Feb 27, 2026
Merged

Add maintenance skill to update SwiftUI API deprecations#29
AvdLee merged 1 commit intomainfrom
feature/update-swiftui-apis-skill

Conversation

@AvdLee
Copy link
Owner

@AvdLee AvdLee commented Feb 27, 2026

Summary

  • Adds a cross-IDE maintenance skill at .agents/skills/update-swiftui-apis/ that codifies the workflow from PR Add version-segmented deprecated API guide (latest-apis.md) #28 into a reusable agent skill
  • Any contributor using Cursor, Claude Code, Codex, or GitHub Copilot can run this skill to scan Apple's documentation for deprecated SwiftUI APIs and update latest-apis.md
  • Includes a scan manifest (references/scan-manifest.md) with categorized API areas, documentation paths, search queries, and WWDC session paths
  • Updates AGENTS.md, CONTRIBUTING.md, and README.md to reference the new skill

What this skill does

Uses the Sosumi MCP to systematically:

  1. Search and fetch Apple developer documentation for SwiftUI API categories
  2. Identify deprecated APIs and their modern replacements
  3. Update swiftui-expert-skill/references/latest-apis.md in the established format
  4. Open a PR with the changes

Why .agents/skills/ instead of .cursor/skills/

The .agents/skills/ directory is tool-agnostic. Combined with the reference in AGENTS.md, the skill is discoverable by all major AI coding tools without IDE-specific configuration.

Test plan

  • Verify SKILL.md frontmatter is valid YAML with name and description
  • Verify scan-manifest.md covers all categories from the existing latest-apis.md
  • Verify AGENTS.md, CONTRIBUTING.md, and README.md references are correct
  • Run the skill manually with Sosumi MCP enabled to confirm the workflow works end-to-end

Copy link

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 9d855079a6

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".


# Update SwiftUI APIs

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

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Point maintenance workflow to a real target file

The new skill’s core workflow tells agents to read and update swiftui-expert-skill/references/latest-apis.md, but that file is not present in this commit’s tree, so the process cannot run as documented and the first step fails immediately for anyone invoking the skill. Because this commit’s stated purpose is to automate API deprecation refreshes, the missing target file blocks the primary maintenance path; either add latest-apis.md in this change or update the workflow/docs to target an existing reference file.

Useful? React with 👍 / 👎.

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.
@AvdLee AvdLee force-pushed the feature/update-swiftui-apis-skill branch from 9d85507 to 4cbd9e0 Compare February 27, 2026 13:20
@AvdLee AvdLee changed the base branch from main to feature/latest-apis-deprecation-guide February 27, 2026 13:21
Base automatically changed from feature/latest-apis-deprecation-guide to main February 27, 2026 17:28
@AvdLee AvdLee merged commit 304573b into main Feb 27, 2026
1 check passed
@AvdLee AvdLee deleted the feature/update-swiftui-apis-skill branch February 27, 2026 17:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant