swiftui-expert

SwiftUI Expert Skill

Expert guidance for any AI coding tool that supports the Agent Skills open format — SwiftUI state management, view composition, performance, and iOS 26+ Liquid Glass adoption.

This repository distills practical SwiftUI best practices into actionable, concise references for agents and code review workflows.

Who this is for

• Teams adopting modern SwiftUI APIs who want quick, correct defaults
• Developers reviewing or refactoring SwiftUI views and data flow
• Anyone shipping performant lists, scrolling, sheets, and navigation in SwiftUI

See also my other skills:

• Swift Concurrency Expert
• Core Data Expert
• Swift Testing Expert
• Xcode Build Optimization Agent Skill
• Xcode Simulator AI Control Agent Skill

How to Use This Skill

Option A: Using skills.sh

Install this skill with a single command:

npx skills add https://github.com/avdlee/swiftui-agent-skill --skill swiftui-expert-skill

For more information, visit the skills.sh platform page.

Then use the skill in your AI agent, for example:

Use the swiftui expert skill and review the current SwiftUI code for state-management and performance improvements

Option B: Claude Code Plugin

Personal Usage

To install this Skill for your personal use in Claude Code:

1. Add the marketplace:

/plugin marketplace add AvdLee/SwiftUI-Agent-Skill

2. Install the Skill:

/plugin install swiftui-expert@swiftui-expert-skill

Option C: Cursor plugin

This repository is packaged as a Cursor plugin. See Cursor plugins documentation for installation instructions.

Project Configuration

To automatically provide this Skill to everyone working in a repository, configure the repository's .claude/settings.json:

{
  "enabledPlugins": {
    "swiftui-expert@swiftui-expert-skill": true
  },
  "extraKnownMarketplaces": {
    "swiftui-expert-skill": {
      "source": {
        "source": "github",
        "repo": "AvdLee/SwiftUI-Agent-Skill"
      }
    }
  }
}

When team members open the project, Claude Code will prompt them to install the Skill.

Option D: Codex / OpenAI-compatible tools

This repository includes an agents/openai.yaml manifest. Copy or symlink the swiftui-expert-skill/ folder into your Codex skills directory:

cp -R swiftui-expert-skill/ "$CODEX_HOME/skills/swiftui-expert-skill"

See Codex skills documentation for details on where to save skills.

Option E: Using pi package manager

Install via pi:

pi install https://github.com/AvdLee/SwiftUI-Agent-Skill

The skill will be available automatically in pi sessions.

Option F: Manual install

1. Clone this repository.
2. Install or symlink the swiftui-expert-skill/ folder following your tool’s official skills installation docs (see links below).
3. Use your AI tool as usual and ask it to use the “swiftui-expert” skill for SwiftUI tasks.

Where to Save Skills

Follow your tool’s official documentation, here are a few popular ones:

• Codex: Where to save skills
• Claude: Using Skills
• Cursor: Plugins documentation or Enabling Skills

How to verify:

Your agent should reference the workflow/checklists in swiftui-expert-skill/SKILL.md and jump into the relevant reference file for your task.

What's Inside