Le point d'entrée officiel de Neon : à charger lors de la création d'applications ou de backends sur Neon, ou lors de mentions de Neon / Lakebase Postgres. L'agent vérifie d'abord l'existence de credentials, puis privilégie l'utilisation de la ligne de commande neon (utilisant MCP uniquement si celle-ci est indisponible) pour se connecter au projet. Il suit le flux « créer une branche git crée une branche de base de données » pour créer des branches, récupère les variables d'environnement telles que DATABASE_URL pour cette branche en local, et utilise neon.ts pour déclarer et neon deploy pour déployer l'authentification (Better Auth hébergé), le stockage d'objets, les Functions, l'AI Gateway et Realtime.
Installations sur skills.sh 251459 (+1114 / 24h)
Audit de sécurité : Non audité
- Pas encore scanné
Justification
- Lors de la modification de projets existants, commencez par un inventaire : réutilisez les DATABASE_URL, Clerk / Better Auth et S3 existants, et ne sélectionnez des composants Neon que pour les fonctionnalités non encore définies ; si les credentials de compte existants sont invalides, arrêtez-vous et demandez à l'utilisateur de se connecter, sans remplacer par un projet temporaire.
- Formalisez le flux de branches avec des commandes spécifiques : effectuez un neon link une fois, puis pour chaque fonctionnalité, utilisez neon checkout <nom_de_branche> --create, qui écrit automatiquement les variables d'environnement de cette branche dans .env.local ; utilisez neon diff pour visualiser les différences de schéma de base de données par rapport à la branche parente, et exigez que l'agent change de branche lui-même entre les tâches.
- Approche prudente en matière de sécurité : il est déconseillé d'exposer PostgREST dans le navigateur pour les nouvelles applications en comptant uniquement sur la protection RLS ; les Functions sont des adresses HTTPS publiques, exigeant la validation d'un JWT ou d'une clé API au début de la fonction de traitement ; pour l'installation MCP au niveau du projet, utilisez toujours OAuth pour éviter d'écrire des clés dans des fichiers soumis à git.
- Il ne s'agit que d'un point d'entrée général ; les tâches spécifiques sont transmises aux sous-compétences du même dépôt telles que neon-postgres, neon-auth, neon-realtime, etc. (il y a 8 autres compétences classées dans le même dépôt) ; le dépôt est sous licence Apache-2.0.
- 24 heures d'installations sur skills.sh : 1114, cumulatif : 251459 ; les installations hebdomadaires au cours des 8 dernières semaines sont passées de 16847 à 22650 (indiquant uniquement le niveau d'attention).
Utilisation
- La commande d'installation s'affichera après validation de l'audit ; elle est déclenchée par des phrases comme « créer un backend avec Neon », des mentions de Lakebase Postgres, neon.new ou « base de données sans inscription ».
- Si vous avez un compte Neon : installez la ligne de commande neon et connectez-vous, ou définissez NEON_API_KEY ; si vous n'avez pas de compte : utilisez Claimable Neon, l'agent crée d'abord un projet temporaire, que vous pouvez ensuite revendiquer ; avant la revendication, les Functions, le stockage d'objets et l'AI Gateway ne sont pas disponibles.
Risques
- Non audité pour cette période, classé fixe en niveau C, la commande d'installation n'est pas affichée ; SKILL.md demande à l'agent d'exécuter des commandes neon pour créer des projets, des branches et déployer, et d'écrire des variables d'environnement telles que les chaînes de connexion de base de données dans les fichiers .env locaux, ce qui modifie les ressources cloud, ce qui est cohérent avec l'usage prévu ; l'audit Gen Agent Trust Hub sur skills.sh est marqué « Pass ».
- neon mcp --agent écrit la clé API dans la configuration utilisateur de l'agent ; si vous ne souhaitez pas que les clés soient enregistrées sur le disque, ajoutez --no-env-pull et utilisez neon-env run pour les injecter à l'exécution.
- SKILL.md indique que les Functions, le stockage d'objets, l'AI Gateway et Realtime ne sont actuellement disponibles que dans 4 régions AWS ; le calcul peut être réduit à zéro mais le stockage reste facturé ; les projets temporaires non revendiqués expirent après environ 72 heures.
- SKILL.md fait environ 3.7 000 octets, ce qui occupe du contexte lors du chargement ; il exige également que l'agent respecte la convention de nommage selon laquelle « la base de données s'appelle Lakebase Postgres, Neon n'étant que la marque ».