Clerk Skills : router intégration et contrôles avec /clerk

À qui ça s’adresse

Utilisez cet ensemble de skills quand un Agent de code doit traiter l’authentification Clerk plus fluidement — surtout pour ajouter Clerk à un nouveau projet ou à n’importe quel framework, ou pour contrôler utilisateurs, organisations, apps, clés d’environnement et déploiements. Les skills suivent le format Agent Skills et s’adressent aux développeurs qui doivent brancher Clerk dans un dépôt et veulent que l’Agent choisisse le bon skill avant d’agir. Le texte officiel marque /clerk comme routeur et dit de toujours commencer là ; ne pas nommer un skill enfant d’emblée. Avant de commencer, il faut pouvoir ouvrir Clerk Dashboard et obtenir des clés inscriptibles dans un fichier d’environnement, sinon intégration et contrôles s’arrêtent sur des clés manquantes.

Premier essai en 3 minutes

Suivre uniquement la commande d’installation du dépôt officiel :

npx skills add clerk/skills

Après installation, préparer d’abord les clés ; ne pas combler avec des placeholders. Ouvrir Clerk Dashboard, copier la clé publiable et la clé secrète, les écrire dans le .env du projet. Les noms de clés doivent être NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY et CLERK_SECRET_KEY. Avant d’écrire, faire seulement répéter à l’Agent ces deux noms et le fichier cible ; n’autoriser la modification qu’après confirmation.

Pour la première tâche, choisir un contrôle réversible, pas un changement de framework. Dans un client qui a déjà chargé les skills, taper /clerk, indiquer un contrôle de déploiement ou une vérification des clés d’environnement, laisser le routeur mener à clerk-cli. Avant toute commande, exiger que l’Agent dise qu’il appellera un contrôle CLI et ne créera pas d’utilisateur ni ne modifiera d’organisation. N’exécuter qu’après confirmation.

Signal de succès : l’Agent passe de /clerk à clerk-cli et renvoie un résultat de clés d’environnement ou de contrôle de déploiement, plutôt qu’une absence de skill ou de clé. Sous Codex, le texte officiel a une commande d’ajout marketplace séparée ; après ajout, redémarrer, ouvrir /plugins, choisir Clerk Skills, installer et activer clerk-skills, puis ouvrir un nouveau fil. C’est une séquence propre à Codex ; ne pas la traiter comme l’installation par défaut.

Cas d’usage

Cas 1 : intégrer un nouveau projet ou n’importe quel framework. Le skill officiel clerk-setup a pour rôle d’ajouter Clerk à n’importe quel framework, pour les nouveaux projets et l’init de framework. Chemin : d’abord /clerk, indiquer le framework actuel et « n’ajouter que l’intégration Clerk », laisser le routeur atterrir sur clerk-setup. Ce type de tâche modifie des fichiers projet ; l’Agent doit lister les fichiers qu’il changera, vous confirmez avant d’écrire. La page ne donne ni liste concrète de frameworks ni rustines pas à pas ; le détail framework suit les notes du skill après installation.

Cas 2 : contrôles d’exploitation en lecture seule via CLI. clerk-cli couvre utilisateurs, organisations, apps, clés d’environnement et contrôles de déploiement. Une fois les clés dans .env, vérifier si une app existante est déployable, si les clés sont complètes, ou consulter utilisateurs et organisations en lecture seule. Encore /clerk d’abord, puis clerk-cli. La page ne liste pas de sous-commandes CLI concrètes ; ne pas inventer de noms de commandes. Ce qui est confirmable, ce sont les catégories de contrôle ci-dessus ; le format de sortie suit l’exécution réelle.

Limites d’usage

Sans clés Dashboard, ne pas commencer l’intégration. Le fichier d’environnement n’utilise que les deux noms officiels ; ne pas les remplacer par des variables non documentées. L’installation par défaut est npx skills add clerk/skills ; l’installation marketplace ne vaut que pour Codex et doit activer clerk-skills dans l’ordre officiel. Toujours partir de /clerk ; la page ne présente pas d’autres entrées comme un moyen de sauter le routeur. Le texte officiel ne dresse pas une liste complète de clients ; ne pas inférer un support exclusif de l’exemple Codex, ni une couverture linguistique des exemples de page. Ne pas inventer de répertoires de skills, commandes marketplace ou échantillons de clés non écrits. Page du dépôt :

https://github.com/clerk/skills

Dashboard :

https://dashboard.clerk.com/