Agent skill

iOS Design

by pproenca in pproenca/dot-skills

SwiftUI interface implementation patterns aligned with the iOS 26 / Swift 6.2 clinic modular MVVM-C architecture, grounded in Creative Selection and Design Like Apple principles.

MITAuto-check passedMobile

Install iOS Design

skills CLI
$ npx skills add pproenca/dot-skills --skill ios-design -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install pproenca/dot-skills ios-design --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/pproenca/dot-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/.experimental/ios-design .claude/skills/ios-design && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ios-design
GitHub stars
214
Token cost
~3.2k tokens
SKILL.md length
1,163 words
Files
66 (incl. references, assets)
Skills in repo
182
Repo updated
First seen
Licence
MIT

At a glance

SwiftUI interface implementation patterns aligned with the iOS 26 / Swift 6.2 clinic modular MVVM-C architecture, grounded in Creative Selection and Design Like Apple principles.

  • Works in 8 steps: Empathy in Every Pixel (CRITICAL) → The Visual System (CRITICAL) → Craft: State as Foundation (CRITICAL) → …
  • Building new SwiftUI views/screens while respecting Domain/Data boundaries
  • SKILL.md covers Scope & Relationship to…, Clinic Architecture Contract…, When to Apply and Rule Categories by Priority, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

iOS Design is an agent skill from pproenca/dot-skills. SwiftUI interface implementation patterns aligned with the iOS 26 / Swift 6.2 clinic modular MVVM-C architecture, grounded in Creative Selection and Design Like Apple principles. Use when building new SwiftUI views/screens while respecting Domain/Data boundaries, App-target route-shell navigation, and production-grade accessibility/interaction standards.

Its SKILL.md is about 3.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 68 other files, including reference files and assets (for example `assets/templates/_template.md`, `metadata.json` and `references/_sections.md`).

It sits in Mobile, covering iOS development. It works with iOS, SwiftUI and Swift. The repository describes itself as: A collection of AI agent skills following the Agent Skills open format. The licence is MIT.

When your agent uses it

  • Building new SwiftUI views/screens while respecting Domain/Data boundaries
  • App-target route-shell navigation
  • Production-grade accessibility/interaction standards

Example prompts

  • “/ios-design”

Workflow steps

8 steps, taken from the step headings in SKILL.md.

  1. Empathy in Every Pixel (CRITICAL)
  2. The Visual System (CRITICAL)
  3. Craft: State as Foundation (CRITICAL)
  4. Creative Composition (HIGH)
  5. Taste: The Right Choice (HIGH)
  6. Navigation as Conversation (HIGH)
  7. Design Out Loud: Layout (HIGH)
  8. The Product Speaks (MEDIUM)

What it can do on your machine

Read from SKILL.md and the folder at commit cf93c57. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

iOS Design loads about 3.2k tokens when it runs, and up to ~53k if it reads all its reference files. Until then it costs about 92 tokens; SKILL.md has 1,163 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~92
When it runs · the whole SKILL.md, loaded when a task matches
~3.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~53k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from pproenca/dot-skills at commit cf93c57, republished under its MIT licence (© pproenca). 1,163 words, ~3,238 tokens.

Download SKILL.mdSave it as .claude/skills/ios-design/SKILL.md (or your agent's skills folder). This skill also uses 65 other files; get the full folder from GitHub.
name
ios-design
description
SwiftUI interface implementation patterns aligned with the iOS 26 / Swift 6.2 clinic modular MVVM-C architecture, grounded in Creative Selection and Design Like Apple principles. Use when building new SwiftUI views/screens while respecting Domain/Data boundaries, App-target route-shell navigation, and production-grade accessibility/interaction standards.

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)

All guidance in this skill assumes the clinic modular MVVM-C architecture:

  • Feature modules import Domain + DesignSystem only (never Data, never sibling features)
  • App target is the convergence point and owns DependencyContainer, concrete coordinators, and Route Shell wiring
  • Domain stays pure Swift and defines models plus repository, *Coordinating, ErrorRouting, and AppError contracts
  • Data owns SwiftData/network/sync/retry/background I/O and implements Domain protocols
  • Read/write flow defaults to stale-while-revalidate reads and optimistic queued writes
  • ViewModels call repository protocols directly (no default use-case/interactor layer)

When to Apply

Reference these guidelines when:

  • Building new SwiftUI views and screens from scratch
  • Choosing between semantic colors, system typography, and spacing grids (Edson's Systems Thinking)
  • Managing state with @State, @Binding, @Observable, @Environment (Kocienda's Craft)
  • Selecting the right component: List vs LazyVStack, Sheet vs FullScreenCover (Kocienda's Taste)
  • Composing views with @ViewBuilder, custom modifiers, and value types (Kocienda's Creative Selection)
  • Implementing navigation with NavigationStack, TabView, sheets (Edson's Conversation)
  • Laying out content with stacks, grids, frames, and adaptive layouts (Edson's Design Out Loud)
  • Ensuring VoiceOver, touch targets, Dark Mode, and reduce motion support (Kocienda's Empathy)
  • Adding transitions, loading states, and animation polish (Edson's Product Is the Marketing)

Rule Categories by Priority

PriorityCategoryPrincipleImpactPrefixRules
1Empathy in Every PixelKocienda "Empathy" · Edson "Design Is About People"CRITICALempathy-8
2The Visual SystemEdson "Systems Thinking" · Kocienda "Convergence"CRITICALsystem-8
3Craft: State as FoundationKocienda "Craft"CRITICALcraft-7
4Creative CompositionKocienda "Creative Selection"HIGHcompose-6
5Taste: The Right ChoiceKocienda "Taste" · Edson "Design with Conviction"HIGHtaste-8
6Navigation as ConversationEdson "Design Is a Conversation" · Kocienda "The Demo"HIGHconverse-9
7Design Out Loud: LayoutEdson "Design Out Loud" · Kocienda "Intersection"HIGHlayout-8
8The Product SpeaksEdson "Product Is the Marketing" · Kocienda "Demo Culture"MEDIUMproduct-8

Quick Reference

1. Empathy in Every Pixel (CRITICAL)

Kocienda: "Empathy — trying to see the world from other people's perspectives." Edson: design begins with the person holding the device.

2. The Visual System (CRITICAL)

Edson: "Zoom out to see relationships between objects." Kocienda: convergence — many decisions narrowing toward one coherent whole.

3. Craft: State as Foundation (CRITICAL)

Kocienda: "Craft — applying skill to achieve a high-quality result."

Show full SKILL.md (476 more words)Show less
4. Creative Composition (HIGH)

Kocienda: "Creative selection — great software is built through composition and recombination."

5. Taste: The Right Choice (HIGH)

Kocienda: "Taste — refined judgment, the ability to choose the one right solution." Edson: commit to one approach and perfect it.

6. Navigation as Conversation (HIGH)

Edson: "Design is a conversation between the product and the person." Kocienda: demos as conversations about whether the interface speaks clearly.

7. Design Out Loud: Layout (HIGH)

Edson: "Design Out Loud — prototype relentlessly until layout feels inevitable." Kocienda: the intersection of technology and liberal arts.

8. The Product Speaks (MEDIUM)

Edson: "The product itself is the marketing." Kocienda: every animation and loading state built to survive Steve Jobs' scrutiny.

How to Use

Read individual reference files for detailed explanations and code examples:

Reference Files

FileDescription
references/_sections.mdCategory definitions and principle grounding
assets/templates/_template.mdTemplate for new rules
metadata.jsonVersion and reference information

© pproenca, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 65 other files (references, assets) in skills/.experimental/ios-design of pproenca/dot-skills.

  • SKILL.md
  • assets/templates/_template.md
  • metadata.json
  • references/_sections.md
  • references/compose-body-some-view.md
  • references/compose-custom-properties.md
  • references/compose-modifier-order.md
  • references/compose-prefer-composition.md
  • references/compose-prefer-value-types.md
  • references/compose-viewbuilder.md
  • references/converse-dismiss.md
  • references/converse-hierarchy.md
  • references/converse-nav-bar.md
  • references/converse-navigationstack.md
  • references/converse-search.md
  • references/converse-sheet-item.md
  • references/converse-tab-bar.md
  • references/converse-tabview.md
  • … and 48 more

Open the folder on GitHubat commit cf93c57

Compare with similar skills

iOS Design next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

iOS Design compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
iOS Design this skillpproenca/dot-skills214—~3.2kAutomated safety check: PassMIT
Swiftui Expert SkillAFK-surf/OpenBridge4302 repos~3.9kAutomated safety check: PassMIT
Swiftui AnimationAstraFoundry/KumoApp290—~4.1kAutomated safety check: PassAGPL-3.0
Snapshot Testsmicrosoft/SwiftStreamingMarkdown377—~2.2kAutomated safety check: PassMIT
Bootstrap iOSRayFernando1337/rayfernando-skills130—~1.1kAutomated safety check: PassApache-2.0
Swiftui Animationdpearson2699/swift-ios-skills1.2k—~3.9kAutomated safety check: PassCustom licence

Similar skills

  • Swiftui Expert Skill

    AFK-surf/OpenBridge

    Write, review, or improve SwiftUI code following best practices for state management, view composition, performance, modern APIs, Swift concurrency, and iOS 26+ Liquid Glass adoption.

    430 GitHub starsUsed in 2 repos~3.9k tokens
    MobileAuto-check passed
  • Swiftui Animation

    AstraFoundry/KumoApp

    Implement, review, or improve SwiftUI animations and transitions.

    290 GitHub stars~4.1k tokensUpdated 4 mo ago
    MobileAuto-check passed
  • Snapshot Tests

    microsoft/SwiftStreamingMarkdown

    Official

    Record and validate swift-snapshot-testing snapshots in the SwiftStreamingMarkdown package: regenerate reference PNGs, run snapshot tests, and diff failed snapshots.

    377 GitHub stars~2.2k tokensUpdated 12 days ago
    MobileAuto-check passed
  • Bootstrap iOS

    RayFernando1337/rayfernando-skills

    Bootstrap agents for iOS, iPadOS, macOS, Swift, SwiftUI, SwiftData/Core Data, Swift Testing, Xcode build/test/debug, Simulator, App Intents, or XcodeBuildMCP work.

    130 GitHub stars~1.1k tokensUpdated 2 mo ago
    MobileAuto-check passed
  • Swiftui Animation

    dpearson2699/swift-ios-skills

    Implement, diagnose, or review SwiftUI motion using explicit and scoped implicit animations, springs, transitions, PhaseAnimator, KeyframeAnimator, matched geometry or navigation zoom, SF Symbol…

    1.2k GitHub stars~3.9k tokensUpdated 2 mo ago
    MobileAuto-check passed
  • iOS Developer

    aiskillstore/marketplace

    Develop native iOS applications with Swift/SwiftUI. An agent skill from aiskillstore/marketplace.

    430 GitHub starsUsed in 6 repos~2.3k tokens
    MobileAuto-check passed

More from pproenca/dot-skills

All 182 skills in this repo
  • Audio Voice Recovery

    pproenca/dot-skills

    Audio forensics and voice recovery guidelines for CSI-level audio analysis.

    214 GitHub stars~3.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Codemod React Pipeline

    pproenca/dot-skills

    Guided, scripted pipeline for running JSX/TSX/React codemods safely across large legacy codebases.

    214 GitHub stars~1.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Dev Rfc

    pproenca/dot-skills

    Create well-structured RFCs and technical proposals for software projects.

    214 GitHub stars~3.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Dx Harness

    pproenca/dot-skills

    Developer-experience friction auditing and fixing — slow onboarding, repeated manual setup steps, missing bootstrap/reset/seed scripts, undiscoverable conventions.

    214 GitHub stars~1.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Language Spec Author

    pproenca/dot-skills

    Turn a rough idea for a language into a complete, implementable specification — a DSL, query, config/data, template, or protocol language — by interviewing the author dimension by dimension until…

    214 GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Python Pep Author

    pproenca/dot-skills

    Drafting Python Enhancement Proposals (PEPs) — proposing a Python language feature, a standard library change, an interoperability standard, or an informational/process document for the Python…

    214 GitHub stars~2.1k tokensUpdated 1 mo ago
    Auto-check passed

Works with

Categories

Questions about iOS Design

What does iOS Design do?

SwiftUI interface implementation patterns aligned with the iOS 26 / Swift 6.2 clinic modular MVVM-C architecture, grounded in Creative Selection and Design Like Apple principles. iOS Design is an agent skill from pproenca/dot-skills.2 clinic modular MVVM-C architecture, grounded in Creative Selection and Design Like Apple principles.

When should I use iOS Design?

iOS Design fits situations like: building new SwiftUI views/screens while respecting Domain/Data boundaries; app-target route-shell navigation; production-grade accessibility/interaction standards.

How do I install iOS Design in Claude Code?

Run `npx skills add pproenca/dot-skills --skill ios-design -a claude-code`. Or copy the skill folder (skills/.experimental/ios-design in pproenca/dot-skills) into .claude/skills/ios-design in your project. Claude Code loads it when a task matches its description.

How do I install iOS Design in Codex?

Run `npx skills add pproenca/dot-skills --skill ios-design -a codex`. Or copy the skill folder (skills/.experimental/ios-design in pproenca/dot-skills) into .agents/skills/ios-design in your project. Codex loads it when a task matches its description.

Can I use iOS Design in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add pproenca/dot-skills --skill ios-design -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ios-design, .gemini/skills/ios-design, .github/skills/ios-design and .opencode/skills/ios-design in your project.

What does iOS Design need to run?

SKILL.md names no scripts, command-line tools or credentials: iOS Design is instructions for the agent only.

Does iOS Design access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is iOS Design safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does iOS Design use?

iOS Design is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does iOS Design use?

About 3.2k tokens (SKILL.md is roughly 13k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 50k tokens, read only when the agent opens those files.

What are the alternatives to iOS Design?

Skills that share tags, products or a category with iOS Design: Swiftui Expert Skill (AFK-surf/OpenBridge, 430 stars), Swiftui Animation (AstraFoundry/KumoApp, 290 stars), Snapshot Tests (microsoft/SwiftStreamingMarkdown, 377 stars) and Bootstrap iOS (RayFernando1337/rayfernando-skills, 130 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains iOS Design?

pproenca (a GitHub user) maintains it in pproenca/dot-skills, which has 214 GitHub stars. The repository holds 182 skills in this directory. The repository was last updated on August 15, 2026.

Source: pproenca/dot-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.