clerk-android
Ce skill fait partie du repository officiel clerk/skills, une collection de skills destinés à aider les agents de coding IA à travailler plus efficacement avec Clerk. Il cible spécifiquement les projets Android natifs en Kotlin et Jetpack Compose, et ne s'applique pas aux projets Expo ou React Native (qui disposent de leur propre skill dédié).
Ce que fait ce skill
Le skill clerk-android guide l'agent à travers l'implémentation de l'authentification Clerk dans une application Android native. Il distingue deux types de flux :
- Prebuilt : utilisation des composants prêts à l'emploi (
AuthView,UserButton) via l'artifactclerk-android-ui. - Custom : implémentation pilotée par l'API Clerk via
clerk-android-api, avec une séparation stricte entre UI, orchestration d'état et intégration SDK.
Avant toute modification de fichier, le skill impose de confirmer le type de flux choisi et de disposer d'une publishable key Clerk valide. Il vérifie également la conformité aux prérequis du quickstart Android officiel (SDK minimum, permissions manifest, initialisation applicative via Clerk.initialize(...)).
Structure et références
Le skill s'appuie sur deux fichiers de référence complémentaires (references/prebuilt.md et references/custom.md) chargés selon le flux retenu. Il s'interdit de mélanger les deux approches sans demande explicite du développeur. Les templates et exemples de code sont systématiquement dérivés des sources et de la documentation officielles du SDK clerk-android, jamais codés en dur dans le skill lui-même.
Comment l'utiliser
Ce skill est activé automatiquement par l'agent lorsqu'une demande concerne Clerk sur Android (présence de build.gradle, AndroidManifest.xml, fichiers Compose, ou mention explicite de Kotlin/Android). Pour démarrer, il suffit de demander à votre agent : « Add Clerk auth to my Android app ». Le skill prendra en charge le routage, posera les questions nécessaires (flux et publishable key), puis guidera l'implémentation étape par étape.