swiftui-expert-skill

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

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 (coming soon)

This repository is now packaged for Cursor plugin submission, but the marketplace listing is not live yet.

Once approved, you'll be able to install it from the Cursor Marketplace.

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

This skill covers the full surface of SwiftUI development -- from state management and view composition to Swift Charts, macOS multi-window scenes, animations, and iOS 26+ Liquid Glass -- without bloating your agent's task context. Reference files load on demand, so your agent gets deep guidance only for the topic at hand.