{"id":45679641,"url":"https://github.com/AvdLee/SwiftUI-Agent-Skill","last_synced_at":"2026-03-09T20:01:20.200Z","repository":{"id":334394640,"uuid":"1139114532","full_name":"AvdLee/SwiftUI-Agent-Skill","owner":"AvdLee","description":"Add expert SwiftUI Best Practices guidance to your AI coding tool (Agent Skills open format).","archived":false,"fork":false,"pushed_at":"2026-03-07T14:25:29.000Z","size":289,"stargazers_count":2006,"open_issues_count":2,"forks_count":91,"subscribers_count":17,"default_branch":"main","last_synced_at":"2026-03-07T17:19:24.468Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AvdLee.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null},"funding":{"github":["avdlee","EngOmarElsayed"]}},"created_at":"2026-01-21T14:42:30.000Z","updated_at":"2026-03-07T17:08:08.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/AvdLee/SwiftUI-Agent-Skill","commit_stats":null,"previous_names":["avdlee/swiftui-agent-skill"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/AvdLee/SwiftUI-Agent-Skill","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AvdLee%2FSwiftUI-Agent-Skill","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AvdLee%2FSwiftUI-Agent-Skill/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AvdLee%2FSwiftUI-Agent-Skill/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AvdLee%2FSwiftUI-Agent-Skill/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AvdLee","download_url":"https://codeload.github.com/AvdLee/SwiftUI-Agent-Skill/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AvdLee%2FSwiftUI-Agent-Skill/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30309998,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-09T17:35:44.120Z","status":"ssl_error","status_checked_at":"2026-03-09T17:35:43.707Z","response_time":61,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-02-24T14:00:36.898Z","updated_at":"2026-03-09T20:01:20.191Z","avatar_url":"https://github.com/AvdLee.png","language":null,"funding_links":["https://github.com/sponsors/avdlee","https://github.com/sponsors/EngOmarElsayed"],"categories":["Python","Skills \u0026 Plugins","AI Agent Frameworks"],"sub_categories":[],"readme":"# SwiftUI Expert Skill\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://github.com/AvdLee/SwiftUI-Agent-Skill/blob/main/LICENSE)\n[![Weekly Installs](https://img.shields.io/badge/weekly%20installs-7.2k-brightgreen)](https://skills.sh/avdlee/swiftui-agent-skill/swiftui-expert-skill)\n[![GitHub Release](https://img.shields.io/github/v/release/AvdLee/SwiftUI-Agent-Skill)](https://github.com/AvdLee/SwiftUI-Agent-Skill/releases)\n[![GitHub Stars](https://img.shields.io/github/stars/AvdLee/SwiftUI-Agent-Skill?style=flat)](https://github.com/AvdLee/SwiftUI-Agent-Skill/stargazers)\n\nExpert guidance for any AI coding tool that supports the [Agent Skills open format](https://agentskills.io/home) — SwiftUI state management, view composition, performance, and iOS 26+ Liquid Glass adoption.\n\nThis repository distills practical SwiftUI best practices into actionable, concise references for agents and code review workflows.\n\n## Who this is for\n- Teams adopting modern SwiftUI APIs who want quick, correct defaults\n- Developers reviewing or refactoring SwiftUI views and data flow\n- Anyone shipping performant lists, scrolling, sheets, and navigation in SwiftUI\n\n## See also my other skills:\n- [Swift Concurrency Expert](https://github.com/AvdLee/Swift-Concurrency-Agent-Skill)\n- [Core Data Expert](https://github.com/AvdLee/Core-Data-Agent-Skill)\n- [Swift Testing Expert](https://github.com/AvdLee/Swift-Testing-Agent-Skill)\n\n## How to Use This Skill\n\n### Option A: Using skills.sh (recommended)\nInstall this skill with a single command:\n\n```bash\nnpx skills add https://github.com/avdlee/swiftui-agent-skill --skill swiftui-expert-skill\n```\n\nFor more information, [visit the skills.sh platform page](https://skills.sh/avdlee/swiftui-agent-skill/swiftui-expert-skill).\n\nThen use the skill in your AI agent, for example:\n\u003e Use the swiftui expert skill and review the current SwiftUI code for state-management and performance improvements\n\n### Option B: Claude Code Plugin\n\n#### Personal Usage\nTo install this Skill for your personal use in Claude Code:\n\n1. Add the marketplace:\n\n```bash\n/plugin marketplace add AvdLee/SwiftUI-Agent-Skill\n```\n\n2. Install the Skill:\n\n```bash\n/plugin install swiftui-expert@swiftui-expert-skill\n```\n\n#### Project Configuration\nTo automatically provide this Skill to everyone working in a repository, configure the repository's `.claude/settings.json`:\n\n```json\n{\n  \"enabledPlugins\": {\n    \"swiftui-expert@swiftui-expert-skill\": true\n  },\n  \"extraKnownMarketplaces\": {\n    \"swiftui-expert-skill\": {\n      \"source\": {\n        \"source\": \"github\",\n        \"repo\": \"AvdLee/SwiftUI-Agent-Skill\"\n      }\n    }\n  }\n}\n```\n\nWhen team members open the project, Claude Code will prompt them to install the Skill.\n\n### Option C: Manual install\n1) **Clone** this repository.\n2) **Install or symlink** the `swiftui-expert-skill/` folder following your tool’s official skills installation docs (see links below).\n3) **Use your AI tool** as usual and ask it to use the “swiftui-expert” skill for SwiftUI tasks.\n\n#### Where to Save Skills\nFollow your tool’s official documentation, here are a few popular ones:\n- **Codex:** [Where to save skills](https://developers.openai.com/codex/skills/#where-to-save-skills)\n- **Claude:** [Using Skills](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview#using-skills)\n- **Cursor:** [Enabling Skills](https://cursor.com/docs/context/skills#enabling-skills)\n\n**How to verify**:\n\nYour agent should reference the workflow/checklists in `swiftui-expert-skill/SKILL.md` and jump into the relevant reference file for your task.\n\n## What This Skill Offers\n\nThis skill gives your AI coding tool practical SwiftUI guidance. It can:\n\n### Guide Your SwiftUI Decisions\n- Choose the right state management tool (`@State`, `@Binding`, `@Observable`, `@Bindable`)\n- Provide clear guidance for sheets, navigation, scrolling, and lists\n- Advise on iOS 26+ Liquid Glass usage with safe availability fallbacks\n\n### Write Better SwiftUI Views\n- Keep view identity stable (e.g. avoid common `ForEach` pitfalls)\n- Improve view composition for readability and efficient diffing\n- Avoid common update/refresh pitfalls that cause unnecessary re-renders\n\n### Improve Performance\n- Reduce redundant state updates in hot paths\n- Improve list performance via stable identity and consistent row structure\n- Suggest image downsampling when `UIImage(data:)` is encountered (as an optional optimization)\n\n## What Makes This Skill Different\n\n**Non-Opinionated**: Focuses on SwiftUI correctness, not forcing an architecture, project structure, or code style.\n\n**Practical \u0026 concise**: Treats the agent as capable; provides the checklists and pitfalls that actually matter in day-to-day SwiftUI work.\n\n## Skill Structure\n\u003c!-- BEGIN REFERENCE STRUCTURE --\u003e\n```text\nswiftui-expert-skill/\n  SKILL.md\n  references/\n    accessibility-patterns.md - Accessibility traits, grouping, Dynamic Type, and VoiceOver\n    animation-advanced.md - Performance, interpolation, and complex animation chains\n    animation-basics.md - Core animation concepts, implicit/explicit animations, timing\n    animation-transitions.md - View transitions, matchedGeometryEffect, and state changes\n    image-optimization.md - AsyncImage usage, downsampling, caching\n    latest-apis.md\n    layout-best-practices.md - Layout patterns and GeometryReader alternatives\n    liquid-glass.md - iOS 26+ glass effects and fallback patterns\n    list-patterns.md - ForEach identity and list performance\n    macos-scenes.md - Scene lifecycle, multi-window setups, and menu bar scenes on macOS\n    macos-views.md - macOS-specific SwiftUI views and platform differences from iOS\n    macos-window-styling.md - Window chrome, toolbar, and title bar styling in SwiftUI\n    performance-patterns.md - Hot-path optimizations and update control\n    scroll-patterns.md - ScrollViewReader and programmatic scrolling\n    sheet-navigation-patterns.md - Sheets and type-safe navigation\n    state-management.md - Property wrapper selection and data flow\n    view-structure.md - View extraction and composition patterns\n```\n\u003c!-- END REFERENCE STRUCTURE --\u003e\n\n## Maintenance\n\nThe repository includes a maintenance skill for keeping API guidance current:\n\n```text\n.agents/skills/update-swiftui-apis/\n  SKILL.md               - Workflow for scanning Apple docs and updating latest-apis.md\n  references/\n    scan-manifest.md     - Categorized API areas, doc paths, and search queries to scan\n```\n\nUse this skill after new iOS or Xcode releases to refresh the deprecated API reference. It requires the [Sosumi MCP](https://github.com/kanaa257/sosumi.ai) to be available. See `AGENTS.md` or `CONTRIBUTING.md` for details.\n\n## Contributing\n\nContributions are welcome! This repository follows the [Agent Skills open format](https://agentskills.io/home), which has specific structural requirements.\n\nPlease read [CONTRIBUTING.md](CONTRIBUTING.md) for:\n- How to contribute improvements to `SKILL.md` and the reference files\n- Format requirements and quality standards\n- Pull request process\n\n## Acknowledgments\n\nSeveral SwiftUI guidelines in this skill were inspired by or derived from the following works:\n\n- [Skills](https://github.com/Dimillian/Skills) by [Thomas Ricouard](https://github.com/Dimillian) — a collection of SwiftUI-focused Codex skills covering UI patterns, performance auditing, and Liquid Glass.\n- [SwiftLee SwiftUI articles](https://www.avanderlee.com/category/swiftui/) and [Swift articles](https://www.avanderlee.com/category/swift/) by [Antoine van der Lee](https://www.avanderlee.com) — practical SwiftUI best practices covering state management, accessibility, view composition, performance debugging, image optimization, and more.\n\n## About the authors\n\nCreated by [Antoine van der Lee](https://www.avanderlee.com) and [Omar Elsayed](https://www.swiftdifferently.com). With years of experience in Swift \u0026 SwiftUI, this skill distills practical knowledge into actionable guidance for AI assistants. Antoine [published tens of articles on SwiftUI](https://www.avanderlee.com/category/swiftui/) on his blog called SwiftLee.\n\n## Resources\n- [Story behind this skill](https://www.swiftdifferently.com/blog/swiftui/How%20I%20stopped-resisting-ai-and-atarted-teaching-it)\n\n## License\n\nThis skill is open-source and available under the MIT License. See [LICENSE](LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAvdLee%2FSwiftUI-Agent-Skill","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FAvdLee%2FSwiftUI-Agent-Skill","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAvdLee%2FSwiftUI-Agent-Skill/lists"}