Agent skill

iOS Design System

by pproenca in pproenca/dot-skills

Clinic-architecture-aligned iOS design system engineering for SwiftUI (iOS 26 / Swift 6.2) covering token architecture, color/typography/spacing systems, component style libraries, asset governance…

MITAuto-check passedFrontend & Design

Install iOS Design System

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

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

GitHub CLI
$ gh skill install pproenca/dot-skills ios-design-system --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-system .claude/skills/ios-design-system && 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-system
GitHub stars
214
Token cost
~2.7k tokens
SKILL.md length
905 words
Files
54 (incl. references, assets)
Skills in repo
182
Repo updated
First seen
Licence
MIT

At a glance

Clinic-architecture-aligned iOS design system engineering for SwiftUI (iOS 26 / Swift 6.2) covering token architecture, color/typography/spacing systems, component style libraries, asset governance…

  • Works in 8 steps: Token Architecture (CRITICAL) → Color System Engineering (CRITICAL) → Component Style Library (CRITICAL) → …
  • Refactoring DesignSystem infrastructure for the clinic modular MVVM-C stack
  • SKILL.md covers Mandated Architecture Alignment, Scope & Relationship to…, Clinic Architecture Contract… and When to Apply, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

iOS Design System is an agent skill from pproenca/dot-skills. Clinic-architecture-aligned iOS design system engineering for SwiftUI (iOS 26 / Swift 6.2) covering token architecture, color/typography/spacing systems, component style libraries, asset governance, and theming. Enforces @Equatable on views and keeps design-system usage compatible with Feature-to-Domain+DesignSystem boundaries. Use when building or refactoring DesignSystem infrastructure for the clinic modular MVVM-C stack.

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

It sits in Frontend & Design, covering Design systems, iOS development and Typography. It works with iOS, Swift and SwiftUI. 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

  • Refactoring DesignSystem infrastructure for the clinic modular MVVM-C stack
  • Tasks that involve Design systems
  • Tasks that involve iOS development

Example prompts

  • “/ios-design-system”

Workflow steps

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

  1. Token Architecture (CRITICAL)
  2. Color System Engineering (CRITICAL)
  3. Component Style Library (CRITICAL)
  4. Typography Scale (HIGH)
  5. Spacing & Sizing System (HIGH)
  6. Consistency & Governance (HIGH)
  7. Asset Management (MEDIUM-HIGH)
  8. Theme & Brand Infrastructure (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 System loads about 2.7k tokens when it runs, and up to ~58k if it reads all its reference files. Until then it costs about 111 tokens; SKILL.md has 905 words of instructions outside code blocks.

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

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). 905 words, ~2,744 tokens.

Download SKILL.mdSave it as .claude/skills/ios-design-system/SKILL.md (or your agent's skills folder). This skill also uses 53 other files; get the full folder from GitHub.
name
ios-design-system
description
Clinic-architecture-aligned iOS design system engineering for SwiftUI (iOS 26 / Swift 6.2) covering token architecture, color/typography/spacing systems, component style libraries, asset governance, and theming. Enforces @Equatable on views and keeps design-system usage compatible with Feature-to-Domain+DesignSystem boundaries. Use when building or refactoring DesignSystem infrastructure for the clinic modular MVVM-C stack.

Airbnb iOS Design System Best Practices

Opinionated, strict design system engineering for SwiftUI iOS 26 / Swift 6.2 apps. Contains 50 rules across 8 categories, prioritized by impact. Derived from Airbnb's Design Language System (DLS), Airbnb Swift Style Guide, Apple Human Interface Guidelines, and WWDC sessions. Mandates @Equatable on every view, @Observable for state, and style protocols as the primary component API.

Mandated Architecture Alignment

This skill is designed to work alongside swift-ui-architect. All code examples follow the same non-negotiable constraints:

  • Feature modules depend on Domain + DesignSystem; no direct Data dependency
  • @Observable for mutable UI state, ObservableObject / @Published never
  • @Equatable macro on every view
  • Style protocols as the primary component styling API (Airbnb DLS pattern)
  • Asset catalog as the source of truth for color values
  • Local SPM package for design system module boundary

Scope & Relationship to Sibling Skills

This skill is the infrastructure layer — it teaches how to BUILD the design system itself. When loaded alongside sibling skills:

Sibling SkillIts FocusThis Skill's Focus
swift-ui-architectArchitecture (modular MVVM-C, route shells, protocol boundaries)Design system infrastructure (tokens, styles, governance)
ios-designUsing design primitives (semantic colors, typography)Engineering the token system that provides those primitives
ios-ui-refactorAuditing/fixing visual quality issuesPreventing those issues via governance and automation
ios-higHIG compliance patternsAsset and component infrastructure that makes compliance easy

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:

  • Setting up a design system for a new iOS app
  • Building token architecture (colors, typography, spacing, sizing)
  • Creating reusable component styles (ButtonStyle, LabelStyle, custom DLS protocols)
  • Organizing asset catalogs (colors, images, icons)
  • Migrating from ad-hoc styles to a governed token system
  • Preventing style drift and enforcing consistency via automation
  • Building theming infrastructure for whitelabel or multi-brand apps
  • Reviewing PRs for ungoverned colors, hardcoded values, or shadow tokens

Rule Categories by Priority

PriorityCategoryImpactPrefixRules
1Token ArchitectureCRITICALtoken-6
2Color System EngineeringCRITICALcolor-7
3Component Style LibraryCRITICALstyle-10
4Typography ScaleHIGHtype-5
5Spacing & Sizing SystemHIGHspace-5
6Consistency & GovernanceHIGHgovern-7
7Asset ManagementMEDIUM-HIGHasset-5
8Theme & Brand InfrastructureMEDIUMtheme-5

Quick Reference

1. Token Architecture (CRITICAL)
2. Color System Engineering (CRITICAL)
Show full SKILL.md (355 more words)Show less
3. Component Style Library (CRITICAL)
4. Typography Scale (HIGH)
5. Spacing & Sizing System (HIGH)
6. Consistency & Governance (HIGH)
7. Asset Management (MEDIUM-HIGH)
8. Theme & Brand Infrastructure (MEDIUM)

How to Use

Read individual reference files for detailed explanations and code examples:

Reference Files

FileDescription
references/_sections.mdCategory definitions and ordering
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 53 other files (references, assets) in skills/.experimental/ios-design-system of pproenca/dot-skills.

  • SKILL.md
  • assets/templates/_template.md
  • metadata.json
  • references/_sections.md
  • references/asset-icon-export-format.md
  • references/asset-image-optimization.md
  • references/asset-naming-convention.md
  • references/asset-separate-catalogs.md
  • references/asset-sf-symbols-first.md
  • references/color-audit-script.md
  • references/color-complete-pairs.md
  • references/color-limit-palette.md
  • references/color-no-hex-in-views.md
  • references/color-organized-xcassets.md
  • references/color-system-first.md
  • references/color-tint-not-brand-everywhere.md
  • references/govern-design-system-directory.md
  • references/govern-lint-for-tokens.md
  • … and 36 more

Open the folder on GitHubat commit cf93c57

Compare with similar skills

iOS Design System 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 System compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
iOS Design System this skillpproenca/dot-skills214—~2.7kAutomated safety check: PassMIT
Design SystemWrongStack/WrongStack368—~3.9kAutomated safety check: PassMIT
Cometchat iOS Customizationcometchat/cometchat-skills129—~1.1kAutomated safety check: PassMIT
Frontend UI StandardsMaxHan7/frontend-ui-standards-skill106—~2.4kAutomated safety check: PassMIT
Frontend Designavibebuilder/claude-prime120—~2.1kAutomated safety check: PassMIT
Refactoring UIwondelai/skills2.4k—~3.9kAutomated safety check: PassMIT

Similar skills

  • Design System

    WrongStack/WrongStack

    Use this skill BEFORE writing or restyling ANY user-facing interface.

    368 GitHub stars~3.9k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Cometchat iOS Customization

    cometchat/cometchat-skills

    Brand and restyle the CometChat iOS UI Kit — theme colours, typography, per-component styles, localisation and sounds.

    129 GitHub stars~1.1k tokensUpdated 2 days ago
    Frontend & DesignAuto-check passed
  • Frontend UI Standards

    MaxHan7/frontend-ui-standards-skill

    A skill your agent uses when implementing, refactoring, or reviewing frontend UI across SwiftUI, React, React Native, Flutter, web, or mobile apps.

    106 GitHub stars~2.4k tokensUpdated 3 mo ago
    Frontend & DesignAuto-check passed
  • Frontend Design

    avibebuilder/claude-prime

    Builds distinctive, production-grade UIs that avoid generic AI aesthetics.

    120 GitHub stars~2.1k tokensUpdated 4 mo ago
    Frontend & DesignAuto-check passed
  • Refactoring UI

    wondelai/skills

    Audit and fix visual hierarchy, spacing, color, and depth in web UIs.

    2.4k GitHub stars~3.9k tokensUpdated 26 days ago
    Frontend & DesignAuto-check passed
  • Apple Hig Designer

    axiaoge2/Apple-Hig-Designer

    Design Apple-style iOS/macOS interfaces following Human Interface Guidelines.

    154 GitHub stars~3.2k tokensUpdated 7 mo ago
    Frontend & DesignAuto-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

Questions about iOS Design System

What does iOS Design System do?

Clinic-architecture-aligned iOS design system engineering for SwiftUI (iOS 26 / Swift 6.2) covering token architecture, color/typography/spacing systems, component style libraries, asset governance…. iOS Design System is an agent skill from pproenca/dot-skills.2) covering token architecture, color/typography/spacing systems, component style libraries, asset governance, and theming.

When should I use iOS Design System?

iOS Design System fits situations like: refactoring DesignSystem infrastructure for the clinic modular MVVM-C stack; tasks that involve Design systems; tasks that involve iOS development.

How do I install iOS Design System in Claude Code?

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

How do I install iOS Design System in Codex?

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

Can I use iOS Design System 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-system -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-system, .gemini/skills/ios-design-system, .github/skills/ios-design-system and .opencode/skills/ios-design-system in your project.

What does iOS Design System need to run?

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

Does iOS Design System 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 System 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 System use?

iOS Design System 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 System use?

About 2.7k tokens (SKILL.md is roughly 11k 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 55k tokens, read only when the agent opens those files.

What are the alternatives to iOS Design System?

Skills that share tags, products or a category with iOS Design System: Design System (WrongStack/WrongStack, 368 stars), Cometchat iOS Customization (cometchat/cometchat-skills, 129 stars), Frontend UI Standards (MaxHan7/frontend-ui-standards-skill, 106 stars) and Frontend Design (avibebuilder/claude-prime, 120 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains iOS Design System?

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.