clerk-swift — Skill Clerk pour iOS natif (Swift)
Ce skill fait partie du repository officiel clerk/skills, qui regroupe un ensemble de skills destinés à aider les agents de code IA à travailler plus efficacement avec Clerk. Le skill clerk-swift est entièrement rédigé et opérationnel : il fournit à un agent Claude un ensemble d'instructions détaillées pour implémenter l'authentification Clerk dans des projets Swift natifs (SwiftUI, UIKit), en s'appuyant sur le package clerk-ios et ses composants ClerkKit / ClerkKitUI.
Périmètre et activation
Le skill s'active lorsque le projet est clairement identifié comme une app iOS/Swift native (présence de .xcodeproj, .xcworkspace, Package.swift, etc.) et que l'utilisateur demande une intégration Clerk. Il ne s'active pas pour les projets Expo ou React Native, qui relèvent d'autres skills (clerk-expo, clerk-setup). Un arbre de décision intégré guide l'agent pour choisir entre deux types de flux : prebuilt (utilisation des vues AuthView/UserButton fournies par ClerkKit) ou custom (flux entièrement piloté par l'API).
Workflow structuré et portes d'exécution
Avant toute modification de fichiers, le skill impose que l'agent dispose de deux informations : le choix de flux (prebuilt ou custom) et une publishable key Clerk valide. Si l'une ou l'autre manque, l'agent doit explicitement les demander à l'utilisateur avant d'agir. Le workflow inclut ensuite : vérification et installation du package clerk-ios, inspection du code source installé de ClerkKitUI pour cartographier les champs Environment utilisés, appel obligatoire à /v1/environment, lecture du quickstart iOS officiel depuis le README du package installé, et vérification de toutes les prérequis (notamment les Associated Domains).
Références de flux et discipline de source
Une fois le type de flux déterminé, le skill charge exclusivement le fichier de référence correspondant (references/prebuilt.md ou references/custom.md) et ne les mélange pas. Toutes les implémentations sont basées sur l'inspection du code source réellement installé — le skill interdit explicitement de coder en dur des exemples figés. Les matrices de capacités ou de champs restent internes à l'agent et ne sont jamais écrites dans le code du projet.
Place dans l'écosystème clerk/skills
Ce skill est référencé dans la table Native Mobile du repository aux côtés de clerk-android et clerk-expo. Il est accessible via les gestionnaires de plugins compatibles Agent Skills (Claude Code, Cursor, Codex, GitHub Copilot CLI) en installant le plugin clerk/skills. Pour tout projet iOS natif, c'est le point d'entrée recommandé ; pour les autres plateformes ou frameworks, le skill principal /clerk route vers le skill adapté.