SwiftUI Agent Skills Guide

Wenn du nur eine auswählst: Nimm ameyalambat128/swiftui-skills, wenn dir von Apple verfasste Vorgaben und weniger erfundene APIs wichtig sind. Nimm dpearson2699/swift-ios-skills, wenn du eine breite Abdeckung der iOS-Entwicklung und präzise Zuordnung nach Framework brauchst. Die stärkste Kombination: Verwende die erste Bibliothek als verlässliche Quelle und installiere aus der zweiten nur die 5–10 spezialisierten Skills, die dein Projekt benötigt.

Das häufigste Problem mit AI-generiertem SwiftUI-Code ist keine ungültige Syntax, sondern Code, der nur korrekt aussieht: unklare Zuständigkeit für den Zustand, veraltete Navigationsmuster, unscharfe Nebenläufigkeitsgrenzen oder eine API, die gar nicht existiert. Agent Skills machen aus einem allgemeinen Modell einen Mitarbeiter mit klaren technischen Vorgaben für Apple-Plattformen.

Was genau ist ein Agent Skill?

Ein Skill ist normalerweise ein Verzeichnis mit einer Datei namens SKILL.md. Sie erklärt Coding-Agenten wie Codex, Claude Code und Cursor, wann sie eine Fähigkeit aktivieren, welche Referenzen sie zuerst lesen, welche Regeln sie befolgen und wie sie das Ergebnis formatieren sollen. Ein Skill ist weder eine Xcode-Erweiterung noch ein Swift-Paket. Er verbindet ein technisches Teamhandbuch mit einem gezielten Wissenspaket für AI.

Statt alle Regeln in einen einzigen langen Prompt zu packen, können Skills nur bei Bedarf geladen werden. Bei SwiftUI-Animationen erscheint die passende Anleitung, bei Aufgaben mit StoreKit werden Regeln für Käufe und Verifizierung geladen, bei der Fehlersuche für ruckelndes Scrollen die Performance-Hinweise. Dieser aufgabenspezifische Kontext ist meist genauer und spart Tokens.

Die beiden Ansätze im Überblick

Ansatz eins: Xcode-Dokumentation als verlässliche AI-Quelle

Die wichtigste Designentscheidung ist die klare Regel, dass jede Tatsachenbehauptung und jede API durch lokale Dateien unter /docs belegt sein muss. Der Agent wählt die Dokumentation vor dem Programmieren aus und nennt bei der Prüfung die verwendeten Dateien. Fehlt ein Typ oder eine API, soll er die Unsicherheit benennen, statt einen plausibel klingenden Namen zu erfinden.

Das extrahierte Material geht über SwiftUI-Layouts hinaus. Es umfasst App Intents, AlarmKit, StoreKit, WebKit, SwiftData-Vererbung, Swift Concurrency, Liquid Glass, visionOS-Widgets sowie grundlegende Performance-Werkzeuge wie InlineArray und Span.

Zu beachtende Einschränkungen

• Erfordert macOS und Xcode 26 oder neuer. Der Skill soll erst SwiftUI-Anleitungen geben, nachdem das Dokumentationsverzeichnis befüllt wurde.
• Der Skill ist ein breiter Einstiegspunkt. Komplexe Projekte brauchen weiterhin eine gezielte Anfrage, etwa „Prüfe die Zuständigkeit für den Zustand und die Navigation anhand der Apple-Dokumentation.“
• Die lokale Xcode-Version bestimmt die Version der Referenzen. Teams sollten ihre Toolchains abstimmen, damit sie nicht zu widersprüchlichen Ergebnissen bei der Verfügbarkeit kommen.

Ansatz zwei: 84 kombinierbare iOS Skills

Die Stärke dieses Repository liegt in der präzisen Zuordnung. Du brauchst nicht bei jeder Aufgabe das gesamte Wissen zur Apple-Entwicklung im Kontext. Eine Abo-App mit SwiftData, StoreKit 2, App Intents und WidgetKit kann diese Skills zusammen mit SwiftUI-Mustern, Swift Concurrency, Tests und Barrierefreiheit installieren.

Unten findest du den vollständigen Katalog mit 84 Skills zum Zeitpunkt der Aktualisierung dieses Artikels. Klappe jede Gruppe auf und gleiche die Abdeckung mit dem Technologie-Stack deines Projekts ab.

So triffst du die Wahl: Beginne mit der Aufgabe, nicht mit der Anzahl

Szenario A: AI erstmals für SwiftUI einsetzen

Installiere zuerst swiftui-skills für die Vorgaben aus der Apple-Dokumentation. Ergänze dann aus der Sammlung mit 84 Skills swiftui-patterns, swiftui-navigation, swift-concurrency, swift-testing und ios-accessibility. Diese fünf decken die häufigsten Fehlerquellen in neuen Projekten ab.

Szenario B: Eine Funktion in einem bestehenden Produkt entwickeln

Wähle nach der aktuell verwendeten Technologie und nicht danach, was irgendwann nützlich sein könnte. Ergänze storekit für Abonnements, app-intents und widgetkit für Systemoberflächen, swiftdata oder core-data für datenintensive Apps sowie apple-on-device-ai für Produkte mit lokaler AI.

Szenario C: Code-Reviews und Zuverlässigkeit

Setze swiftui-performance, debugging-instruments, metrickit, swift-security, ios-accessibility und app-store-review an erste Stelle. Diese Auswahl dient eher als Kontrollpunkt vor der Veröffentlichung denn als Codegenerator.

Installation: Allgemeine Agenten und Codex

Lokalen Skill für Apple-Dokumentation installieren

# Direkt installieren und Dokumentation aus Xcode extrahieren
curl -fsSL https://swiftui-skills.ameyalambat.com/install | bash

# Oder die skills CLI verwenden
npx skills add ameyalambat128/swiftui-skills

Prüfe das Installationsskript im Repository, bevor du ein entferntes Skript per Pipe an deine Shell übergibst. Führe nach der Installation setup.sh aus dem Verzeichnis des installierten Skills aus und starte die Agent-Sitzung neu, damit sie den neuen Skill erkennt.

Skills interaktiv aus der Sammlung mit 84 Skills auswählen

# Interaktive Auswahl öffnen und Skills sowie Ziel-Agenten wählen
npx skills add dpearson2699/swift-ios-skills

# Nur ausgewählte Fähigkeiten installieren
npx skills add dpearson2699/swift-ios-skills \
  --skill swiftui-patterns \
  --skill swift-concurrency \
  --skill swift-testing

# Prüfen und aktualisieren
npx skills check
npx skills update

Einen einzelnen Skill in Codex installieren

$skill-installer install \
  https://github.com/dpearson2699/swift-ios-skills/tree/main/skills/swiftui-patterns

Ersetze das letzte Verzeichnis durch einen beliebigen Skill-Namen aus dem Katalog. Projektspezifische Regeln gehören in den Projektbereich. Wiederverwendbare Vorgaben für SwiftUI und Entwicklung gehören in den persönlichen, gemeinsam genutzten Bereich.

Ein zuverlässigerer kombinierter Workflow

1. Ziel und Deployment Target nennen. Teile dem Agenten mit, ob es um eine Funktion, ein Refactoring oder eine Prüfung geht. Nenne außerdem die niedrigste iOS-Version, damit neue APIs nicht ohne Prüfung verwendet werden.
2. Zuerst die verlässliche Quelle Dokumentation auswählen lassen. Bitte swiftui-skills, die verwendeten Apple-Dokumente und Verfügbarkeitsvorgaben für die Aufgabe aufzulisten.
3. Nur aufgabenspezifische Skills laden. Verwende swiftui-navigation für Navigation und storekit für Käufe, statt den gesamten Katalog zu einer Aufgabe hinzuzufügen.
4. Vollständige Prüfung verlangen. Bitte den Agenten, das Target zu bauen und Tests auszuführen. Bei Änderungen an der Oberfläche soll er außerdem Dynamic Type, VoiceOver und den Dunkelmodus prüfen.
5. Entscheidungen in Projektregeln festhalten. Wiederkehrende Architekturentscheidungen gehören in einen Projekt-Skill oder in AGENTS.md, damit sie nicht bei jeder Aufgabe neu verhandelt werden.

Ein wiederverwendbarer Aufgaben-Prompt kann so beginnen:

Use local Apple documentation as the API source of truth,
and use swiftui-patterns, swift-concurrency, and swift-testing.
Goal: implement a testable asynchronous loading screen for an iOS 26 app.
List the selected documentation and state ownership first, then modify the code, build, and run tests.
Do not introduce an architecture that the project does not already use.

Versionen und Lizenzen: zwei abschließende Prüfungen

APIs für Apple-Plattformen ändern sich schnell. Dieser Artikel wurde anhand eines Commits von swiftui-skills vom July 6, 2026 und eines Commits von swift-ios-skills vom July 4, 2026 geprüft. Inhalte der Repositorys, unterstützte Versionen und die Anzahl der Skills können sich ändern. Prüfe Beta-Frameworks immer anhand des aktuellen Xcode SDK.

Auch die Lizenzen unterscheiden sich: swiftui-skills verwendet MIT, swift-ios-skills PolyForm Perimeter 1.0.0. Diese Lizenz erlaubt App-Entwicklung und geschlossene kommerzielle Workflows, beschränkt aber das erneute Verpacken der Inhalte als Konkurrenzprodukt. Lies vor einer Verteilung im Team, einer Änderung oder einer kommerziellen Integration die LICENSE-Datei des Ursprungsprojekts.

Häufig gestellte Fragen

Ersetzen SwiftUI Agent Skills die offizielle Apple-Dokumentation?

Nein. Ein Skill hilft einem Agenten, Regeln zum richtigen Zeitpunkt zu laden und anzuwenden. Die endgültige API-Verfügbarkeit, das Plattformverhalten und die Anforderungen von App Review solltest du weiterhin anhand des aktuellen Xcode SDK und offiziellen Materials von Apple prüfen.

Kann ich beide Skill-Bibliotheken installieren?

Ja. Sie ergänzen sich: Die eine bietet eine lokale, verlässliche Quelle für Apple-Dokumentation, die andere gezielte Framework- und Entwicklungsworkflows. Wähle die Skills pro Projekt aus, statt standardmäßig alles zu installieren.

Ist es besser, alle 84 Skills zu installieren?

Nicht unbedingt. Teams, die viele Projekte für Apple-Plattformen pflegen, können davon profitieren. Bei einem einzelnen Produkt sorgen fünf bis zehn häufig verwendete Skills meist für mehr Klarheit und erleichtern die Zuordnung einer Anleitung zu ihrer Quelle.

Sind diese Skills nur für Codex gedacht?

Nein. Beide Repositorys unterstützen mehrere Agenten, darunter Codex, Claude Code und Cursor. Installationspfade und Erkennungsmechanismen hängen von der aktuellen Version des jeweiligen Agenten ab.