swiftui-mvvm SKILL.md skillA

swiftui-mvvm from rusel95/ios-agent-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add rusel95/ios-agent-skills/swiftui-mvvm@v1.0.4

Pins v1.0.4 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
rusel95/ios-agent-skills
Path
skills/swiftui-mvvm/SKILL.md
Versions recorded
5
Latest version
v1.0.4, committed Apr 16, 2026
First version recorded
Mar 28, 2026
Size
16,991 bytes
Repository stars
12
License
MIT

Use this skill when working with SwiftUI ViewModels — creating, refactoring, or testing them. Triggers for: setting up a ViewModel for a SwiftUI screen, extracting logic from a View into a ViewModel, migrating from ObservableObject to @Observable, modeling async state (instead of separate Bool flags like isLoading/hasError), injecting dependencies into ViewModels, writing unit tests for @Observable ViewModels, NavigationStack/Router setup, or any question about SwiftUI app architecture. Also…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

> **Approach: Production-First Iterative Refactoring** — This skill is built for production enterprise codebases where stability and reviewability matter more than speed. Architecture changes are delivered through iterative refactoring — small, focused PRs (≤200 lines, single concern) tracked in a `refactoring/` directory. Critical safety issues ship first; cosmetic improvements come last.

# SwiftUI MVVM Architecture (iOS 17+)

Enterprise-grade SwiftUI MVVM architecture skill. Opinionated: prescribes @Observable ViewModels, Router navigation, constructor injection, ViewState enum, and Repository-based networking. Adopts a **production-first iterative refactoring** approach — every pattern is chosen for testability, reviewability, and safe incremental adoption in large teams. For non-architectural SwiftUI API guidance (animations, modern API replacements, Liquid Glass), use a general SwiftUI skill instead.

## Architecture Layers

```
View Layer         → SwiftUI Views. Declarative UI only. Owns ViewModel via @State.
ViewModel Layer    → @Observable @MainActor final class. Exposes ViewState<T>.
Repository Layer   → Protocol-based data access. Hides data source details.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add rusel95/ios-agent-skills/swiftui-mvvm@sha256:2938efec0189cb18

The line at the top of this page pins the label v1.0.4, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_6r4h47qn3vm5hssz.svg)](https://markdownregistry.com/a/art_6r4h47qn3vm5hssz)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Mar 28, 2026 and Apr 16, 2026, about one every 5 days.

versioncommittedcommitsizeaudit
v1.0.4 latest2026-04-16 b28e891 16,991 BA view · diff
v1.0.42026-04-15 1b84388 17,013 BA view · diff
v1.0.42026-04-12 e05f6ae 17,026 BA view · diff
v1.0.22026-04-02 1c054d5 12,097 BA view · diff
v1.0.22026-03-28 f7a9b06 12,030 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (16991 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

rusel95/ios-agent-skills · 12 stars · license MIT · pushed 2026-10-13 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_6r4h47qn3vm5hssz
GET https://markdownregistry.com/api/v1/resolve?ref=rusel95/ios-agent-skills/swiftui-mvvm
GET https://markdownregistry.com/api/v1/blob/2938efec0189cb186cd25af31a2ccc29244199c2b6fc0794f9064d2e9e634f11

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from rusel95/ios-agent-skills

AGENTS.md AGENTS.md file
rusel95/ios-agent-skills · AGENTS.md
git:20260919.5a3d61a · audit A · 12 stars
skill-benchmarking SKILL.md skill
rusel95/ios-agent-skills · scripts/benchmarking/SKILL.md · Run skill benchmarks with discriminating-only assertions against evals.json for any model and any AI agent. Use when…
git:20260402.2fa77b8 · audit A · 12 stars
gcd-operations SKILL.md skill
rusel95/ios-agent-skills · skills/gcd-operations/SKILL.md · Use for iOS/macOS concurrency problems involving dispatch queues, locks, or thread safety. Triggers on: deadlocks (sync…
v1.0.3 · audit A · 12 stars
ios-accessibility SKILL.md skill
rusel95/ios-agent-skills · skills/ios-accessibility/SKILL.md · Production-grade iOS accessibility skill covering VoiceOver, Dynamic Type, color contrast, motion, Switch Control…
v1.0.2 · audit A · 12 stars
ios-localization SKILL.md skill
rusel95/ios-agent-skills · skills/ios-localization/SKILL.md · Production-grade iOS localization skill covering String Catalogs (.xcstrings), CLDR pluralization, SwiftUI/UIKit…
v1.0.2 · audit A · 12 stars
ios-logging SKILL.md skill
rusel95/ios-agent-skills · skills/ios-logging/SKILL.md · Enterprise skill for iOS production error observability and logging (iOS 15+, Swift 5.5+). The trigger is OBSERVABILITY…
v1.0.3 · audit A · 12 stars
ios-security SKILL.md skill
rusel95/ios-agent-skills · skills/ios-security/SKILL.md · Use for any iOS security question — whether you're asking about a specific vulnerability, checking if a pattern is…
v1.1.4 · audit A · 12 stars
ios-testing SKILL.md skill
rusel95/ios-agent-skills · skills/ios-testing/SKILL.md · Invoke any time a user is writing iOS/Swift tests or asking why tests behave a certain way — including XCTest versus…
v2.1.3 · audit A · 12 stars
swift-concurrency SKILL.md skill
rusel95/ios-agent-skills · skills/swift-concurrency/SKILL.md · Use for any Swift Concurrency question on Apple platforms. Triggers on: actor reentrancy (stale state after await)…
v1.1.2 · audit A · 12 stars
tca-swiftui SKILL.md skill
rusel95/ios-agent-skills · skills/tca-swiftui/SKILL.md · Use for any question about The Composable Architecture (TCA) — defining reducers, managing state, handling navigation…
v1.0.3 · audit A · 12 stars
uikit-mvvm SKILL.md skill
rusel95/ios-agent-skills · skills/uikit-mvvm/SKILL.md · Use for hands-on UIKit MVVM questions: setting up Combine bindings between UIViewController and ViewModel (@Published +…
v1.0.4 · audit A · 12 stars
viper-uikit SKILL.md skill
rusel95/ios-agent-skills · skills/viper-uikit/SKILL.md · Use when working with VIPER architecture in iOS/UIKit apps. Triggers on: creating new VIPER modules…
v1.0.2 · audit A · 12 stars

Every file in rusel95/ios-agent-skills

Browse by kind, by grade A, or by owner.