A comprehensive reference for building SwiftUI interfaces that actually feel like Apple designed them, grounded in Ken Kocienda's Creative Selection and John Edson's Design Like Apple. You get 62 specific rules organized by priority, from accessibility basics like VoiceOver labels and 44pt touch targets to state management patterns with @Observable and semantic color systems. Each rule calls out an anti-pattern and shows the correct iOS 26 / Swift 6.2 implementation. This is the greenfield companion to ios-ui-refactor. Use it when building new screens from scratch, especially if you're tired of SwiftUI code that works but feels off compared to system apps.

skills.sh installs
436
GitHub stars
222
last updated
Aug 21, 2026

Install

$ npx -y skills add pproenca/dot-skills --skill ios-design --agent claude-code

Installs into .claude/skills of the current project.

Files

Apple SwiftUI iOS Design Best Practices

A builder's guide for implementing Apple-quality iOS interfaces in SwiftUI, grounded in two foundational design texts:

  • Ken Kocienda — Creative Selection (empathy for the user, craft in coding, taste in choosing the best solution, demo culture of iterative refinement)
  • John Edson — Design Like Apple (systems thinking, the product is the marketing, design out loud, design with conviction)

Contains 62 rules across 8 principle-based categories. Each rule identifies a specific anti-pattern, grounds the fix in a named principle, and provides the correct iOS 26 / Swift 6.2 SwiftUI implementation.

Scope & Relationship to Sibling Skills

This skill is the building and implementation guide — it teaches how to construct new SwiftUI interfaces from scratch using Apple-quality patterns. When loaded alongside ios-ui-refactor (reviewing/refactoring existing UI), this skill covers the greenfield implementation that ios-ui-refactor later audits. Use this skill for building new screens; use the sibling for evaluating and improving existing ones.

Clinic Architecture Contract (iOS 26 / Swift 6.2)

Sponsors

Details

Repository
github.com/pproenca/dot-skills
Categories
Code Review & Quality, Mobile Development, Design & UI/UX, CLI & Terminal
First seen
Jun 3, 2026

More from pproenca/dot-skills

All 100
1bobmatnyc avatarwordpress-plugin-fundamentalsbobmatnyc/claude-mpm-skillsModern WordPress plugin development with PHP 8.3+, OOP architecture, hooks system, database interactions, and Settings API434skills.sh installs
2onewave-ai avatardatabase-schema-designeronewave-ai/claude-skillsDesign optimized database schemas for SQL and NoSQL databases including tables, relationships, indexes, and constraints. Creates ERD diagrams, migration scripts426skills.sh installs
3davila7 avatarprompt-librarydavila7/claude-code-templatesCurated collection of high-quality prompts for various use cases. Includes role-based prompts, task-specific templates, and prompt refinement techniques. Use wh423skills.sh installs
4tristanmanchester avatarstyling-nativewind-v4-expotristanmanchester/agent-skillsSets up and uses NativeWind v4 (Tailwind CSS v3) in Expo React Native apps, including Expo Router. Configures tailwind.config.js, global.css, babel.config.js (j420skills.sh installs
5webflow avatarcms-best-practiceswebflow/webflow-skillsExpert guidance on Webflow CMS architecture and best practices. Use when planning collections, setting up relationships, optimizing content structure, or troubl419skills.sh installs
6jwynia avatargitea-workflowjwynia/agent-skillsOrchestrate agile development workflows for Gitea repositories using the tea CLI. Use when working with Gitea-hosted repos and asking to 'run the workflow', 'co416skills.sh installs