clerk-swift – Skill d'intégration Clerk pour iOS natif
Ce skill fait partie du repository officiel clerk/skills, une collection de skills au format Agent Skills conçus pour aider les agents de coding IA à travailler efficacement avec Clerk. clerk-swift couvre spécifiquement l'intégration de l'authentification Clerk dans les projets iOS natifs en Swift, SwiftUI ou UIKit via le package clerk-ios (ClerkKit / ClerkKitUI).
Ce que fait ce skill
Le skill définit un protocole structuré que l'agent doit suivre pour implémenter Clerk dans un projet iOS natif. Il précise deux chemins d'implémentation : prebuilt (utilisation des vues AuthView / UserButton fournies par ClerkKitUI) et custom (flows d'authentification entièrement pilotés par l'API). Avant tout code, l'agent doit confirmer le type de projet, obtenir la publishable key Clerk, inspecter le source installé de ClerkKitUI, appeler l'endpoint /v1/environment, puis auditer le projet contre la checklist du quickstart iOS officiel (associated domains, capabilities, etc.).
Le skill s'active uniquement sur des projets Swift/iOS natifs (présence d'un .xcodeproj, .xcworkspace, Package.swift, etc.) et se désactive explicitement si le projet est Expo ou React Native — dans ce cas, l'agent est redirigé vers d'autres skills du repo.
Structure et règles d'exécution
Le SKILL.md contient un arbre de décision, neuf « Execution Gates » (étapes obligatoires qui ne peuvent pas être sautées), un tableau des pièges courants classés par criticité, et des références vers deux fichiers complémentaires : references/prebuilt.md et references/custom.md. L'agent doit charger exactement l'un de ces deux fichiers selon le flow choisi, sans les mélanger sauf demande explicite du développeur.
Comment l'utiliser
Il suffit de demander à votre agent de coding (par exemple dans Claude) : « Add Clerk auth to my iOS app ». Le skill clerk-swift sera activé, l'agent posera les questions nécessaires (type de flow, publishable key), puis suivra le protocole défini pour configurer et implémenter l'authentification dans votre projet Xcode. Pour l'installer, référez-vous aux instructions du repo parent (npx skills add clerk/skills ou clonage manuel dans ~/.claude/skills/clerk).