slack

Overview

What the slack skill does

La compétence slack automatise de vrais espaces de travail Slack en pilotant l’application web Slack dans votre navigateur. Elle utilise agent-browser pour contrôler une session Slack existante, ce qui vous permet de :

• Vérifier quels canaux et DMs contiennent des messages non lus
• Naviguer dans l’interface Slack (Activity, DMs, canaux, recherche)
• Extraire des données structurées depuis les vues Slack
• Capturer des captures d’écran comme preuves pour vos rapports
• Intégrer des contrôles Slack répétables dans des workflows d’automatisation plus larges

Comme elle s’exécute sur l’interface web Slack en temps réel, cette compétence respecte vos droits d’accès existants, la configuration de votre espace de travail et votre authentification.

Who this skill is for

Utilisez la compétence slack si vous :

• Surveillez plusieurs espaces de travail Slack et avez besoin de contrôles d’état rapides et reproductibles
• Exécutez des workflows d’exploitation, de support ou de gestion d’incidents qui dépendent des messages dans Slack
• Souhaitez qu’un agent ou un job CLI scanne Slack et produise des synthèses ou des rapports
• Préférez l’automatisation par navigateur (sans créer d’app Slack ni gérer des tokens API)

Elle convient particulièrement aux ingénieurs, SRE/ops, analystes et à toute personne qui construit de l’automatisation de workflows ou de l’automatisation navigateur autour de Slack.

What problems it solves

Vérifier Slack manuellement est lent et source d’erreurs. La compétence slack vous aide à :

• Identifier de façon systématique tous les canaux et DMs non lus
• Capturer des preuves (captures d’écran, instantanés) pour la conformité ou les revues d’incident
• Générer des rapports d’activité Slack cohérents à partir de modèles
• Réutiliser des schémas de navigation communs au lieu de réapprendre l’interface à chaque fois

Si vous vous surprenez à penser « vérifie mon Slack » ou « montre-moi tous les canaux avec des non lus » dans un script ou lors de l’exécution d’un agent, cette compétence est faite pour ça.

When slack is not a good fit

Envisagez d’autres approches si :

• Vous avez besoin d’exports de données massifs ou d’analyses historiques approfondies (les APIs ou exports Slack seront sans doute plus adaptés)
• Vous ne pouvez pas exécuter de navigateur ou exposer de port de débogage (la compétence repose sur l’automatisation de navigateur)
• Vous avez besoin d’un accès purement programmatique sans aucune interaction avec l’UI

Pour de nombreux workflows opérationnels, utiliser l’UI web Slack existante via agent-browser reste toutefois la manière la plus rapide de démarrer.

---

How to Use

Installation and setup

1. Add the slack skill

Installez la compétence slack dans l’environnement de compétences de votre agent avec npx :

npx skills add https://github.com/vercel-labs/agent-browser --skill slack

Cette commande récupère la définition de la compétence slack et ses fichiers associés (dont SKILL.md, les références et les templates) depuis le dépôt vercel-labs/agent-browser.

2. Prepare a Slack browser session

La compétence slack part du principe que Slack est ouvert ou disponible dans un navigateur que agent-browser peut contrôler.

Schéma de configuration courant :

# Option A : se connecter à une session de navigateur existante (Slack déjà ouvert)
agent-browser connect 9222

# Option B : ouvrir Slack directement s’il n’est pas déjà lancé
agent-browser open https://app.slack.com

Le port exact (9222 ci-dessus) dépend de la façon dont votre navigateur est lancé avec le débogage distant activé. Adaptez-le à votre environnement.

3. Confirm agent-browser access

Une fois connecté ou ouvert, prenez un snapshot pour vérifier que l’interface Slack est accessible :

agent-browser snapshot -i

Le snapshot liste les éléments interactifs (avec des refs comme @e1, @e2, etc.) sur lesquels vous pourrez cliquer, lire et que vous pourrez automatiser dans vos commandes ultérieures.

---

Core workflow pattern

1. Connect or open Slack

Chaque session commence par l’attachement à l’application web Slack :

agent-browser connect 9222
# or
agent-browser open https://app.slack.com

2. Discover elements with a snapshot

Utilisez un snapshot pour voir ce que Slack affiche actuellement :

agent-browser snapshot -i

Vous verrez des références comme @e14 pour l’onglet Activity, @e13 pour les DMs, ou une ref pour le bouton « More unreads ». Ces refs vous permettent de script­er une navigation fiable.

3. Navigate to the relevant view

Cliquez sur les onglets, développez les barres latérales ou ouvrez les sections nécessaires :

# Exemple : ouvrir l’onglet Activity
agent-browser click @e14
agent-browser wait 1000

Effectuez de nouveaux snapshots après navigation pour découvrir de nouveaux éléments et textes.

4. Extract information or take actions

Une fois sur la bonne vue, vous pouvez :

• Lire le texte des messages, les noms de canaux ou les compteurs à partir des snapshots
• Ouvrir des canaux ou DMs spécifiques
• Faire défiler et capturer des captures d’écran pour une synthèse ultérieure

Exemple de schéma pour vérifier les non lus :

agent-browser connect 9222
agent-browser snapshot -i
# Cherchez "More unreads" dans la sortie du snapshot
agent-browser click @e21   # Ref d’exemple pour le bouton "More unreads"
agent-browser screenshot slack-unreads.png

5. Capture evidence

Les captures d’écran et les notes structurées sont souvent nécessaires pour les audits liés à Slack, les revues d’incident ou les comptes rendus quotidiens (standups).

Utilisez :

agent-browser screenshot activity.png

et appuyez-vous sur le template de rapport fourni (voir ci-dessous) pour transformer vos constats bruts en rapport standardisé.

---

Common Slack automation tasks

Le dépôt inclut references/slack-tasks.md, qui documente des schémas pas à pas pour les workflows les plus fréquents. Parmi les tâches clés :

Check all unread messages across Slack

À utiliser lorsque vous voulez une vue complète de tout ce que vous n’avez pas encore lu.

Étapes globales (voir references/slack-tasks.md pour le détail complet) :

1. Se connecter à Slack :

   agent-browser connect 9222
   

2. Ouvrir l’onglet Activity et vérifier si Slack indique qu’il n’y a aucun non lu.
3. Passer à l’onglet DMs et identifier les conversations avec des badges de non lus.
4. Développer "More unreads" dans la barre latérale des canaux pour lister les canaux non lus.
5. Capturer des captures d’écran de chaque vue et les combiner dans une synthèse.

Ce schéma est idéal pour une automatisation planifiée de type « check my Slack » ou pour un agent qui doit confirmer que vous êtes à jour avant de poursuivre.

Find all channels in a workspace

À utiliser lorsque vous avez besoin de l’inventaire des canaux auxquels vous avez accès :

1. Se connecter et prendre un snapshot :

   agent-browser connect 9222
   agent-browser snapshot -i
   

2. Repérer la section "Channels" dans la barre latérale.
3. Cliquer pour la développer et capturer une capture d’écran (par exemple all-channels.png).
4. Extraire les noms de canaux à partir de la sortie du snapshot.

Cette approche sert de base aux automatisations qui cartographient la structure des canaux, catégorisent l’activité ou génèrent des vues d’ensemble de l’espace de travail.

---

Using templates and references

Reference playbooks

Le dossier references/ fournit des instructions prêtes à l’emploi pour l’automatisation Slack :

• references/slack-tasks.md – schémas documentés pour vérifier les non lus, lister les canaux et d’autres workflows courants.

Vous pouvez l’utiliser comme playbook pour vos agents ou scripts, en réutilisant ces séquences comme briques de base.

Reporting templates

Le dossier templates/ contient un template de rapport structuré :

• templates/slack-report-template.md – une trame de rapport Markdown pour l’analyse Slack.

Il inclut des sections pour :

• Les volumes de non lus par Activity, DMs et canaux
• Les listes de canaux et DMs non lus
• Les statistiques de snapshot de canaux
• Les canaux les plus actifs et les conversations clés

Utilisez ce template pour standardiser la façon dont vos automatisations synthétisent les informations Slack pour vos parties prenantes.

---

Files to review first

Pour comprendre et étendre la compétence slack, ouvrez ces fichiers dans le dépôt :

• SKILL.md – la définition principale de la compétence slack, sa description et les outils autorisés
• references/slack-tasks.md – les enchaînements détaillés de tâches et les schémas d’automatisation
• templates/slack-report-template.md – la structure des rapports Slack lisibles par un humain

Ces fichiers montrent les modèles d’utilisation prévus sans que vous ayez besoin d’inspecter tout le dépôt.

---

FAQ

What is the slack skill in agent-browser?

La compétence slack est un profil d’automatisation réutilisable qui apprend à agent-browser comment interagir avec les espaces de travail Slack via l’interface web Slack. Elle se concentre sur des tâches comme la vérification des non lus, la navigation entre les canaux et les DMs, la recherche et l’extraction de données, le tout via l’automatisation de navigateur plutôt que via les APIs Slack directes.

How do I install the slack skill?

Installez-la via npx à partir du dépôt vercel-labs/agent-browser :

npx skills add https://github.com/vercel-labs/agent-browser --skill slack

Après l’installation, assurez-vous de pouvoir exécuter agent-browser et de vous connecter à un navigateur où Slack est ouvert ou peut être ouvert.

Do I need a Slack app or API token to use this skill?

Non. La compétence slack interagit avec l’application web Slack dans votre navigateur. Tant que vous êtes connecté à Slack dans ce navigateur et que agent-browser peut le contrôler, la compétence peut effectuer ses tâches en utilisant vos droits d’accès et autorisations existants.

Can this skill read all messages in my workspace?

La compétence ne peut voir que ce que votre compte Slack connecté voit via l’interface web. Elle ne contourne pas les permissions. Elle est surtout adaptée aux contrôles opérationnels (non lus, listes de canaux, activité récente) plutôt qu’aux exports historiques complets de tous les messages.

How stable are element refs like @e14 or @e21?

Les refs comme @e14 sont générées par chaque agent-browser snapshot et peuvent changer d’une session à l’autre ou lorsque Slack met à jour son interface. Les schémas de references/slack-tasks.md montrent comment rechercher des libellés comme "Activity", "DMs" ou "More unreads" dans la sortie du snapshot, puis utiliser dynamiquement la ref correspondante plutôt que de coder en dur des numéros.

Is the slack skill suitable for headless or server environments?

Elle peut être utilisée partout où vous pouvez lancer un navigateur avec débogage distant et où agent-browser peut se connecter. Si votre environnement ne peut pas exécuter ou atteindre un navigateur, cette compétence basée sur le navigateur ne conviendra pas, et une intégration basée sur API sera probablement plus appropriée.

What categories of automation does this skill support?

La compétence slack est principalement un outil d’automatisation de workflows et secondairement un outil d’automatisation navigateur. Elle est particulièrement adaptée aux workflows pilotés par CLI ou agents qui doivent :

• Vérifier l’état Slack avant d’exécuter d’autres jobs
• Rassembler des informations depuis Slack dans le cadre de processus d’incident ou de support
• Produire des rapports standardisés d’activité Slack à partir de templates

Where can I learn the detailed task flows?

Ouvrez la vue Files de la compétence et consultez :

• SKILL.md pour la définition globale et les exemples de démarrage rapide
• references/slack-tasks.md pour les instructions détaillées tâche par tâche
• templates/slack-report-template.md pour la structure de reporting

Ces documents fournissent suffisamment de détails pour décider comment adapter la compétence slack à vos propres workflows et contraintes.