Rôle du skill synthlabs-setup
Ce skill fait partie du repo mkurman/zorai, une plateforme d'exécution multi-agents persistante et auditable. Il appartient à la collection de skills situés sous skills/synthlabs/ et constitue le point d'entrée obligatoire pour tout agent qui doit interagir avec un backend SynthLabs local avant d'effectuer du travail de génération, de curation ou de révision.
Son rôle est clairement défini : localiser un checkout de SynthLabs, démarrer les services locaux selon le chemin disponible (npm, bun, ou Docker Compose via ./mc.sh), et vérifier la santé du backend via GET /health avant toute autre action. Ce contrat de disponibilité — une réponse JSON {"ok":true,"service":"synthlabs-rg"} — est la condition sine qua non pour passer aux étapes suivantes.
Ce que couvre ce skill
Le SKILL.md est ici pleinement rédigé et opérationnel, pas un simple squelette. Il documente de façon exhaustive : la détection du checkout, le choix du package manager, la gestion prudente des fichiers .env.local et .env (sans jamais écraser l'existant ni inventer de secrets), les scripts de démarrage documentés, les ports attendus selon le mode d'exécution (développement sur 8787, Docker Compose sur 8900), et les erreurs courantes à éviter.
Quand l'utiliser dans Zorai
Dans le contexte de la plateforme Zorai, ce skill est destiné à être invoqué par les agents (notamment Swarog, Domowoj ou Swarozyc) lorsqu'une tâche longue durée nécessite un backend SynthLabs sain. Il ne doit pas être utilisé si une instance SynthLabs est déjà connue et opérationnelle, ou si la tâche porte sur l'utilisation des routes API plutôt que sur la mise en place de l'environnement.
Limites et garde-fous
Le skill insiste explicitement sur ce qu'il ne faut pas faire : ne jamais fabriquer de clés API, de credentials Firebase ou de valeurs de base de données, et ne jamais remplacer un .env.local existant. Si aucune instance saine ne peut être trouvée après les étapes de diagnostic, l'agent doit s'arrêter et rapporter l'échec précis plutôt que de poursuivre avec des suppositions.