Guide des Agent Skills SwiftUI

Si vous ne devez en choisir qu’une : optez pour ameyalambat128/swiftui-skills afin de suivre les recommandations écrites par Apple et de réduire les hallucinations d’API ; optez pour dpearson2699/swift-ios-skills pour couvrir largement l’ingénierie iOS et sélectionner précisément les frameworks. La meilleure combinaison : utilisez la première comme couche de référence et n’installez depuis la seconde que les 5–10 Skills spécialisés dont votre projet a besoin.

Le problème le plus courant du code SwiftUI généré par l’IA n’est pas une syntaxe invalide, mais un code qui semble simplement correct : propriété de l’état mal définie, anciens modèles de navigation, limites floues pour la concurrence ou API inexistante. Les Agent Skills transforment un modèle généraliste en collaborateur qui suit des contraintes explicites d’ingénierie pour les plateformes Apple.

Qu’est-ce qu’un Agent Skill, exactement ?

Un Skill est généralement un répertoire qui contient un fichier SKILL.md. Il indique aux agents de programmation tels que Codex, Claude Code et Cursor quand activer une capacité, quelles références lire en premier, quelles règles suivre et comment présenter le résultat. Ce n’est ni une extension Xcode ni un package Swift. Voyez-le comme un manuel d’ingénierie d’équipe accompagné d’un ensemble ciblé de connaissances pour l’IA.

Au lieu d’un seul prompt immense qui regroupe toutes les règles, les Skills peuvent se charger uniquement lorsqu’ils sont pertinents. Les recommandations sur les animations apparaissent pour les travaux d’animation SwiftUI, les règles d’achat et de vérification StoreKit pour les tâches commerciales, et les recommandations de performance lors du débogage du défilement. Ce contexte propre à chaque tâche est généralement plus précis et consomme moins de tokens.

Les deux approches en un coup d’œil

Première approche : faire de la documentation Xcode une référence pour l’IA

Son choix de conception le plus utile tient dans une règle explicite : chaque affirmation factuelle et chaque API doivent s’appuyer sur le répertoire local /docs. L’agent sélectionne la documentation avant de programmer et cite les fichiers utilisés pendant la revue. Si un type ou une API en est absent, il doit reconnaître l’incertitude au lieu d’inventer un nom plausible.

Le contenu extrait dépasse la mise en page SwiftUI. Il inclut App Intents, AlarmKit, StoreKit, WebKit, l’héritage SwiftData, Swift Concurrency, Liquid Glass, les widgets visionOS et des primitives de performance de bas niveau telles que InlineArray et Span.

Limites à garder à l’esprit

• Nécessite macOS et Xcode 26 ou une version ultérieure. Le Skill ne doit fournir aucune recommandation SwiftUI tant que le répertoire de documentation n’a pas été rempli.
• Il sert de point d’entrée général. Les projets complexes ont encore besoin d’une demande ciblée, par exemple « vérifiez la propriété de l’état et la navigation par rapport à la documentation Apple ».
• La version locale de Xcode détermine celle des références. Les équipes doivent donc harmoniser leurs chaînes d’outils pour éviter des conclusions contradictoires sur la disponibilité.

Deuxième approche : 84 Skills iOS combinables

Ce dépôt excelle dans la sélection précise des capacités. Vous n’avez pas besoin de tout le corpus de développement Apple dans chaque contexte. Une app avec abonnement qui utilise SwiftData, StoreKit 2, App Intents et WidgetKit peut installer ces Skills avec les modèles SwiftUI, Swift Concurrency, les tests et l’accessibilité.

Vous trouverez ci-dessous le catalogue complet des 84 Skills à la date de mise à jour de cet article. Développez chaque groupe pour comparer sa couverture avec les technologies de votre projet.

Comment choisir : partez de la tâche, pas du nombre

Scénario A : commencer à utiliser l’IA avec SwiftUI

Installez d’abord swiftui-skills pour appliquer les contraintes de la documentation Apple, puis ajoutez swiftui-patterns, swiftui-navigation, swift-concurrency, swift-testing et ios-accessibility depuis la collection de 84 Skills. Ces cinq Skills couvrent les sources d’erreur les plus fréquentes dans les nouveaux projets.

Scénario B : développer une fonctionnalité dans un produit existant

Choisissez selon les technologies utilisées maintenant, pas selon ce qui pourrait servir un jour. Ajoutez storekit pour les abonnements, app-intents et widgetkit pour les surfaces système, swiftdata ou core-data pour les apps qui traitent beaucoup de données, et apple-on-device-ai pour les produits d’IA sur l’appareil.

Scénario C : revue de code et fiabilité

Donnez la priorité à swiftui-performance, debugging-instruments, metrickit, swift-security, ios-accessibility et app-store-review. Cet ensemble se comporte davantage comme un gardien avant publication que comme un générateur de code.

Installation : agents généralistes et Codex

Installer le Skill de documentation Apple locale

# Installer directement et extraire la documentation depuis Xcode
curl -fsSL https://swiftui-skills.ameyalambat.com/install | bash

# Ou utiliser l’interface en ligne de commande skills
npx skills add ameyalambat128/swiftui-skills

Avant d’envoyer un script distant directement dans votre shell, examinez le programme d’installation dans le dépôt. Après l’installation, exécutez setup.sh depuis le répertoire du Skill installé, puis redémarrez la session de l’agent pour qu’il puisse détecter le nouveau Skill.

Sélectionner de façon interactive dans la collection de 84 Skills

# Ouvrir le sélecteur interactif et choisir les Skills et les agents cibles
npx skills add dpearson2699/swift-ios-skills

# Installer uniquement les capacités sélectionnées
npx skills add dpearson2699/swift-ios-skills \
  --skill swiftui-patterns \
  --skill swift-concurrency \
  --skill swift-testing

# Vérifier et mettre à jour
npx skills check
npx skills update

Installer un seul Skill dans Codex

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

Remplacez le dernier répertoire par le nom de n’importe quel Skill du catalogue. Les règles propres au projet doivent rester dans son périmètre. Les recommandations SwiftUI et d’ingénierie réutilisables doivent rester dans le périmètre personnel partagé.

Un processus combiné plus fiable

1. Déclarez l’objectif et la cible de déploiement. Indiquez à l’agent si la tâche porte sur une fonctionnalité, un remaniement ou une revue, et précisez la version minimale d’iOS afin que les nouvelles API ne soient pas utilisées sans condition.
2. Laissez d’abord la couche de référence sélectionner la documentation. Demandez à swiftui-skills d’énumérer les documents Apple et les contraintes de disponibilité utilisés pour la tâche.
3. Chargez uniquement les Skills propres à la tâche. Utilisez swiftui-navigation pour la navigation et storekit pour les achats au lieu d’ajouter tout le catalogue à une seule tâche.
4. Exigez une validation complète. Demandez à l’agent de compiler la cible, d’exécuter les tests et de vérifier Dynamic Type, VoiceOver et le mode sombre pour les modifications d’interface.
5. Consignez les décisions dans les règles du projet. Les décisions d’architecture récurrentes doivent figurer dans un Skill du projet ou dans AGENTS.md au lieu d’être renégociées à chaque tâche.

Un prompt de tâche réutilisable peut commencer ainsi :

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.

Versions et licences : deux dernières vérifications

Les API des plateformes Apple évoluent rapidement. Cet article a été vérifié à partir d’un commit de swiftui-skills daté du July 6, 2026 et d’un commit de swift-ios-skills daté du July 4, 2026. Le contenu des dépôts, les versions prises en charge et le nombre de Skills peuvent changer. Vérifiez toujours les frameworks bêta par rapport au SDK Xcode actuel.

Les licences diffèrent également : swiftui-skills utilise MIT, tandis que swift-ios-skills utilise PolyForm Perimeter 1.0.0. Cette dernière autorise le développement d’apps et les processus commerciaux à code source fermé, mais interdit de reconditionner le contenu sous forme de produit concurrent. Lisez le fichier LICENSE en amont avant toute distribution au sein de l’équipe, modification ou intégration commerciale.

Questions fréquentes

Les Agent Skills SwiftUI remplacent-ils la documentation officielle Apple ?

Non. Un Skill aide un agent à charger et à appliquer les règles au bon moment. La disponibilité finale des API, le comportement des plateformes et les exigences de validation doivent toujours être vérifiés par rapport au SDK Xcode actuel et aux ressources officielles Apple.

Puis-je installer les deux bibliothèques de Skills ?

Oui. Elles sont complémentaires : l’une fournit une source de référence locale pour la documentation Apple, tandis que l’autre apporte des processus ciblés pour les frameworks et l’ingénierie. Sélectionnez les Skills pour chaque projet au lieu de tout installer par défaut.

Vaut-il mieux installer les 84 Skills ?

Pas nécessairement. Les équipes qui gèrent de nombreux projets pour les plateformes Apple peuvent en tirer parti. Pour un seul produit, cinq à dix Skills fréquemment utilisés offrent généralement plus de clarté et permettent de retrouver plus facilement l’origine des recommandations.

Ces Skills sont-ils réservés à Codex ?

Non. Les deux dépôts prennent en charge plusieurs agents, notamment Codex, Claude Code et Cursor. Les chemins d’installation et les mécanismes de détection dépendent de la version actuelle de chaque agent.