Individual skill
ios-design-system
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.
skills/.experimental/ios-design-system/SKILL.md
Source commit cf93c57cac89d6fc3e4194686000411567f5caf3
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- Yes
- Repository scan complete
- No
- Skill scan complete
- No
- Observed behavior
- Instructions only
- Last checked
- Nov 5, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 222
- Repository last updated
- Aug 15, 2026
- License
- MIT
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
- engineering Derived category
- design Derived category
- devops Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
SKILL.mdcore · 10,979 bytesSKILL.mdcore · 10,979 bytesassets/templates/_template.mddoc · 805 bytesmetadata.jsonasset · 1,670 bytesreferences/_sections.mddoc · 2,744 bytesreferences/asset-icon-export-format.mddoc · 2,573 bytesreferences/asset-image-optimization.mddoc · 3,800 bytesreferences/asset-naming-convention.mddoc · 3,882 bytesreferences/asset-separate-catalogs.mddoc · 2,655 bytesreferences/asset-sf-symbols-first.mddoc · 2,636 bytesreferences/color-audit-script.mddoc · 5,261 bytesreferences/color-complete-pairs.mddoc · 4,818 bytesreferences/color-limit-palette.mddoc · 5,706 bytesreferences/color-no-hex-in-views.mddoc · 5,213 bytesreferences/color-organized-xcassets.mddoc · 5,952 bytesreferences/color-system-first.mddoc · 5,998 bytesreferences/color-tint-not-brand-everywhere.mddoc · 5,692 bytesreferences/govern-design-system-directory.mddoc · 5,417 bytesreferences/govern-lint-for-tokens.mddoc · 4,759 bytesreferences/govern-migration-incremental.mddoc · 4,647 bytesreferences/govern-naming-conventions.mddoc · 3,815 bytesreferences/govern-prevent-local-tokens.mddoc · 5,373 bytesreferences/govern-single-source-of-truth.mddoc · 3,464 bytesreferences/govern-spm-package-boundary.mddoc · 4,395 bytesreferences/space-insets-pattern.mddoc · 4,367 bytesreferences/space-no-magic-numbers.mddoc · 4,283 bytesreferences/space-radius-tokens.mddoc · 3,239 bytesreferences/space-size-tokens.mddoc · 4,472 bytesreferences/space-token-enum.mddoc · 3,710 bytesreferences/style-accessibility-first.mddoc · 4,396 bytesreferences/style-catalog-file.mddoc · 5,107 bytesreferences/style-configuration-over-parameters.mddoc · 5,042 bytesreferences/style-dls-protocol-pattern.mddoc · 5,741 bytesreferences/style-environment-awareness.mddoc · 5,137 bytesreferences/style-equatable-views.mddoc · 4,267 bytesreferences/style-preview-catalog.mddoc · 5,847 bytesreferences/style-protocol-over-wrapper.mddoc · 4,616 bytesreferences/style-static-member-syntax.mddoc · 4,134 bytesreferences/style-view-for-containers-modifier-for-styling.mddoc · 4,677 bytesreferences/theme-brand-layer-separation.mddoc · 4,884 bytesreferences/theme-dont-over-theme.mddoc · 3,960 bytesreferences/theme-environment-key.mddoc · 4,198 bytesreferences/theme-light-dark-only.mddoc · 4,144 bytesreferences/theme-tint-for-brand.mddoc · 3,727 bytesreferences/token-asset-catalog-source.mddoc · 4,998 bytesreferences/token-avoid-over-abstraction.mddoc · 4,882 bytesreferences/token-enum-over-struct.mddoc · 3,740 bytesreferences/token-shapestyle-extensions.mddoc · 4,705 bytesreferences/token-single-file-per-domain.mddoc · 4,830 bytesreferences/token-three-layer-hierarchy.mddoc · 4,432 bytesreferences/type-avoid-font-design-mixing.mddoc · 3,373 bytesreferences/type-custom-font-registration.mddoc · 3,342 bytesreferences/type-max-styles-per-screen.mddoc · 3,810 bytesreferences/type-scale-enum.mddoc · 2,308 bytesreferences/type-system-styles-first.mddoc · 2,813 bytes
Read excerpt
# 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