Agent skills de Xcode : comment les exporter et les utiliser dans Xcode 27

Les agents de code écrivent bien du Swift, mais ils apprennent les API à partir de leurs données d'entraînement, qui ont généralement une ou deux versions de retard. Les agent skills de Xcode comblent cet écart. Xcode 27 inclut des skills rédigés par Apple qui expliquent à un agent comment appliquer les bonnes pratiques actuelles et utiliser les API les plus récentes, et une seule commande les exporte pour les agents qui tournent en dehors de Xcode. Ce guide explique ce que sont ces skills, comment les exporter, pourquoi une copie antérieure à Xcode 27.1 est dépassée, et comment le skill App Resizability vous aide à préparer une app pour l'iPhone Duo.

Tout ce qui suit provient des sessions de la WWDC26, des Tech Talks sur l'iPhone Duo, de la documentation et des notes de version d'Apple, ainsi que de signalements de développeurs, que nous citons lorsqu'ils sont la seule source. L'équipe AppleDuo n'a pas utilisé ces skills sur une app publiée. Xcode 27.x est récent : noms et comportements peuvent changer d'une version à l'autre.

Que sont les agent skills de Xcode 27 ?

Un skill est un paquet d'expertise qu'un agent peut charger quand une tâche l'exige. La documentation d'Apple sur l'extension et la personnalisation des agents le décrit comme une expertise intégrée capable de guider les agents vers les meilleures API et les meilleurs workflows pour des tâches de haut niveau. Dans Xcode, vous avez rarement besoin d'en demander un : Xcode utilise le bon skill selon la requête que vous tapez.

Vous pouvez aussi appeler un skill directement. Les notes de version de Xcode 27 indiquent que les skills peuvent être invoqués sous forme de commandes slash, avec complétion. Tapez / dans le champ de message de l'assistant de code pour voir tous les skills de votre copie de Xcode. La même version a ajouté des plug-ins qui regroupent skills, serveurs MCP et configurations d'agent : la liste peut donc s'étendre au-delà de ceux d'Apple.

Dans la session What's new in SwiftUI de la WWDC26, Apple explique que les nouveaux skills sont là pour vous aider à adopter les fonctionnalités des versions 2027, et à améliorer les performances et la justesse du code de votre app. C'est l'idée centrale : l'agent reçoit les recommandations actuelles d'Apple au lieu de s'appuyer sur des données d'entraînement plus anciennes.

Quels agent skills sont inclus dans Xcode 27 ?

Apple n'a pas publié de liste unique. Voici les skills cités dans les sessions et notes de version d'Apple, avec la version qui a introduit chacun d'eux.

Xcode inclut aussi des skills de workflow, comme /plan pour le mode plan, et les notes de version mentionnent des spécialistes conçus par Apple pour la localisation, le redimensionnement UIKit et l'accessibilité. Votre dossier exporté reste la liste la plus fiable pour la version de Xcode installée.

Comment exporter les agent skills de Xcode avec xcrun ?

Apple donne la commande dans deux sessions de la WWDC26. Dans Modernize your UIKit app, le présentateur explique que, pour utiliser les skills dans d'autres outils, vous pouvez exporter ceux qu'utilise Xcode avec xcrun agent skills export, qui crée des fichiers Markdown à importer dans vos workflows.

@sarunw a partagé la version avec un dossier de sortie :

xcrun agent skills export --output-dir ~/Downloads/xcode-skills

xcrun exécute l'outil depuis votre répertoire développeur actif : assurez-vous d'abord qu'il pointe vers Xcode 27 ou ultérieur. L'article de Reda Lemeden note que vous pouvez revenir en arrière ensuite, car les fichiers exportés restent là où vous les avez placés. Les commandes xcode-select ci-dessous sont des outils macOS standard ; adaptez le chemin à l'emplacement de votre Xcode.

# Vérifier quel Xcode xcrun va utiliser
xcode-select -p

# Pointer vers Xcode 27.1 ou ultérieur, puis exporter
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
xcrun agent skills export --output-dir ~/Downloads/xcode-skills
ls ~/Downloads/xcode-skills

D'après Lemeden, lancer la commande sans --output-dir exporte dans le répertoire courant, avec un dossier par skill. Apple n'a pas documenté d'autres options, nous n'en listons donc aucune.

Peut-on utiliser les agent skills de Xcode avec Claude Code ou d'autres agents ?

Oui, c'est tout l'intérêt de l'export. La page de préparation à l'iPhone Duo d'Apple le dit clairement : si vous utilisez un autre agent de code, exportez le skill. Ce qu'Apple ne documente pas, c'est la façon dont chaque agent doit charger les fichiers. Cela dépend de l'agent.

Lemeden indique exporter directement dans un dossier de skills Claude Code, et précise que les fichiers fonctionnent avec tout environnement qui prend en charge le format des skills, en citant Claude Code et OpenCode :

xcrun agent skills export --output-dir ~/.claude/skills

Un dossier par projet fonctionne aussi si vous préférez garder les skills avec un seul dépôt. Quel que soit votre agent, consultez sa documentation pour savoir où se trouvent les skills et comment ils se déclenchent.

Deux remarques pratiques. D'abord, les skills sont du contenu d'Apple. Exportez-les depuis votre propre copie de Xcode plutôt que de récupérer une copie publiée par quelqu'un d'autre, pour obtenir la version qui correspond à votre SDK. Ensuite, un agent extérieur à Xcode ne peut vérifier son travail que s'il peut compiler et lancer votre app. Les notes de version de Xcode 27 décrivent un aperçu d'un serveur MCP de Xcode qui fonctionne sans espace de travail ouvert, activé avec sudo xcrun mcp-server enable. C'est un aperçu précoce : attendez-vous à quelques imperfections.

Si des agents modifient votre fichier de projet en plus de votre code, le nouveau format de projet JSON de Xcode 27.2 est plus facile à lire et à fusionner pour eux. Nous le présentons dans le format .xcproj de Xcode 27.

Pourquoi réexporter les skills après Xcode 27.1 ?

Les skills sont versionnés avec Xcode, et Xcode 27.1 en a modifié un qui compte pour l'iPhone Duo. Dans le Tech Talk Prepare your app for iPhone Duo, Apple indique que le skill de modernisation d'app présenté dans « Modernize your UIKit app » porte un nouveau nom dans Xcode 27.1 : App Resizability, qui prend désormais en charge SwiftUI et l'iPhone Duo.

@sarunw a précisé ce que cela implique pour les copies exportées : si vous avez exporté avant Xcode 27.1, exportez à nouveau, car uikit-app-modernization est devenu app-resizability. Un dossier exporté depuis Xcode 27.0 conserve l'ancien skill, qui ne sait rien de l'iPhone Duo ni de SwiftUI.

Avant de réexporter, supprimez l'ancien dossier, ou exportez vers un nouveau chemin, pour que votre agent ne charge pas les deux versions. Faites de même après chaque mise à jour de Xcode, car Apple peut réviser n'importe quel skill d'une version à l'autre.

Comment utiliser le skill App Resizability pour l'iPhone Duo ?

Dans Xcode, la page de préparation à l'iPhone Duo d'Apple conseille de demander à l'assistant de code « get my app ready for iPhone Duo » (préparer mon app pour l'iPhone Duo). Le skill analyse votre projet et, pour chaque problème trouvé, l'explique et propose une correction. Avec une copie exportée, faites la même demande à votre agent et indiquez-lui le skill.

La session UIKit de la WWDC26 liste ce que le skill fait de lui-même : il convertit les appels à l'écran principal en vérifications de trait collection ou des limites de la scène, remplace les tests d'orientation de l'interface par des tests de size class, et peut faire passer une app au cycle de vie des scènes. Pour les tâches plus importantes, il pose des questions de clarification, et pour un travail trop volumineux pour une seule session, il laisse des commentaires afin que vous puissiez suivre ce qui reste à faire.

Une modification typique ressemble à ceci. Les deux lignes utilisent l'API UIKit standard, et la page de préparation d'Apple mentionne précisément ce remplacement :

// Avant : dimensionnée d'après l'écran principal
let window = UIWindow(frame: UIScreen.main.bounds)

// Après : créée depuis la scène, elle suit donc la taille de la scène
let window = UIWindow(windowScene: windowScene)

Apple est clair : le skill trouve la plupart des problèmes, mais pas tous. Utilisez son passage comme un premier balayage, puis vérifiez les schémas qu'Apple vous demande de corriger à la main :

• Ne dimensionnez plus d'après l'écran principal. Remplacez UIScreen.main.bounds par view.bounds ou window.bounds, et utilisez GeometryReader ou onGeometryChange en SwiftUI.
• N'utilisez pas l'orientation pour la mise en page. Supprimez la logique de mise en page qui lit UIDevice.current.orientation, statusBarOrientation ou interfaceOrientation.
• Ne confondez pas idiome ou size class avec un appareil. Sur iPhone Duo, une app iPhone peut recevoir n'importe quelle combinaison de size classes : une largeur regular ne signifie plus iPad. Notre guide des size classes de l'iPhone Duo entre dans les détails.
• Vérifiez les médias plein cadre. Les images d'en-tête en mode remplissage peuvent perdre du contenu sur l'écran intérieur, plus large.

Compilez ensuite avec le SDK iOS 27.1, qui étend les apps à tout l'écran avec des barres verticales, puis testez. Notre checklist pour préparer votre app à l'iPhone Duo met ces étapes dans l'ordre.

Qu'est-ce qui a changé dans Device Hub avec Xcode 27.2 ?

Les modifications d'un agent doivent toujours être testées, et c'est dans Device Hub que cela se passe. Avec Xcode 27.1, vous choisissez le simulateur iPhone Duo et utilisez les commandes en bas de l'écran pour ouvrir, fermer, faire pivoter ou plier l'appareil. Les notes de version de Xcode 27.2 ajoutent une liste d'améliorations, dont plusieurs mises en avant par @sarunw :

• Prise en charge de StandBy sur iPhone Duo
• Slow Motion Animation, Simulate Shake, Simulate Fall et Simulate Memory Pressure (simulateurs uniquement)
• Événements tactiles via Sidecar, pour que le pincement et la rotation fonctionnent depuis l'écran d'un iPad
• Une option pour masquer les contours de l'appareil, ainsi que des améliorations des captures d'écran et du clavier

Le ralenti vous aide à observer un changement de mise en page pendant que l'appareil se plie, et la pression mémoire montre si votre état survit à un redimensionnement sous charge. Les notes de 27.2 d'Apple listent aussi des problèmes connus : VoiceOver et l'Accessibility Inspector ne peuvent pas restituer le contenu de l'écran de l'iPhone Duo dans Device Hub, et les captures d'écran peuvent être noires pendant quelques minutes après le démarrage de l'appareil.

Ce qu'il faut retenir

• Les agent skills de Xcode 27 sont des recommandations rédigées par Apple pour les agents de code, appliquées automatiquement ou via des commandes slash.
• Exportez-les avec xcrun agent skills export suivi de --output-dir et d'un dossier pour les utiliser avec un autre agent ; Apple indique que l'export produit des fichiers Markdown.
• Réexportez après Xcode 27.1 : uikit-app-modernization est devenu app-resizability, avec la prise en charge de SwiftUI et de l'iPhone Duo.
• Demandez « get my app ready for iPhone Duo », puis vérifiez ce que le skill a manqué, car Apple précise qu'il ne détecte pas tout.
• Testez le résultat dans Device Hub, qui gagne dans Xcode 27.2 des simulations de ralenti, de pression mémoire, de secousse et de chute.

Parcourez ensuite la checklist de préparation à l'iPhone Duo, et découvrez dans Built for the fold des apps qui tirent déjà le meilleur parti de la charnière.