Skill Slack — Guide de configuration du bridge Slack × CMA
Ce skill, situé dans managed_agents/slack/ du repository anthropics/claude-cookbooks, n'est pas un squelette vide : il constitue un guide de référence approfondi pour mettre en place un bridge entre Slack et l'API Claude Managed Agents (CMA). Son contenu documente l'architecture, les pièges courants et une checklist de démarrage pour développeurs.
Architecture décrite
Le document expose un modèle à deux webhooks : un endpoint /slack/events qui reçoit les @mentions depuis Slack, et un endpoint /cma-webhook qui reçoit les signaux d'idle de session CMA. Le principe central est que ces webhooks ne transportent que des identifiants (signaux), jamais les données de réponse — celles-ci doivent être récupérées activement via sessions.retrieve() et sessions.events.list(). L'état de routage (canal Slack, thread) est entièrement stocké dans les metadata de la session CMA, ce qui rend le bridge lui-même stateless.
Contenu pratique
Le skill liste les points de friction les plus fréquents lors de l'intégration : la distinction entre scopes OAuth et souscriptions aux événements Slack, la confusion entre tokens xoxb- et xapp-, la contrainte de la fenêtre de 3 secondes imposée par Slack pour l'acquittement, le périmètre workspace des webhooks Anthropic, et la gestion de l'idempotence sur les deux systèmes. Une checklist en 8 étapes couvre l'ensemble du flux de setup local avec ngrok et bun.
Utilisation dans le contexte du cookbook
Ce skill s'inscrit dans la collection Claude Cookbooks, un ensemble de recettes et guides pratiques destinés aux développeurs souhaitant intégrer Claude dans leurs projets. Il sert de référence technique complémentaire au code source du bridge Slack présent dans le même dossier managed_agents/slack/, et peut être consulté directement lors de la configuration ou du débogage de l'intégration.