slack

Overview

What the slack skill does

Der slack Skill automatisiert reale Slack Workspaces, indem er die Slack Web-App in deinem Browser steuert. Er nutzt agent-browser, um eine bestehende Slack Session zu kontrollieren, sodass du:

• siehst, in welchen Channels und DMs ungelesene Nachrichten sind
• in der Slack UI navigierst (Activity, DMs, Channels, Suche)
• strukturierte Daten aus Slack Views extrahierst
• Screenshots als Nachweise für Reports erstellst
• wiederholbare Slack Checks in größere Automatisierungs-Workflows einbaust

Da der Skill direkt gegen die Live-Slack-Weboberfläche läuft, verwendet er deine bestehenden Berechtigungen, dein Workspace-Layout und deine Authentifizierung.

Who this skill is for

Nutze den slack Skill, wenn du:

• mehrere Slack Workspaces überwachst und schnelle, wiederholbare Status-Checks brauchst
• Operations-, Support- oder Incident-Workflows betreibst, die von Nachrichten in Slack abhängen
• möchtest, dass ein Agent oder ein CLI-Job Slack scannt und Zusammenfassungen oder Reports erzeugt
• Browser-Automatisierung bevorzugst (kein eigenes Slack App Setup oder API-Token-Management)

Er passt besonders gut für Engineers, SRE/Ops, Analyst:innen und alle, die Workflow Automation oder Browser Automation auf Basis von Slack aufbauen.

What problems it solves

Manuelles Slack-Checking ist langsam und fehleranfällig. Der slack Skill hilft dir:

• alle Channels und DMs mit ungelesenen Nachrichten systematisch zu identifizieren
• Nachweise (Screenshots, Snapshots) für Compliance- oder Incident-Reviews zu erfassen
• konsistente Slack Aktivitätsreports aus Vorlagen zu generieren
• wiederkehrende Navigationsmuster wiederzuverwenden, statt die UI jedes Mal neu zu erkunden

Wenn du dir in Skripten oder Agent-Runs denkst „check my Slack“ oder „zeige mir alle Channels mit unreads“, ist dieser Skill genau dafür gedacht.

When slack is not a good fit

Ziehe andere Ansätze in Betracht, wenn:

• du umfangreiche, hochvolumige Datenexports oder historische Analysen brauchst (Slack APIs oder Exports sind hier meist besser)
• du keinen Browser laufen lassen oder keinen Debug-Port freigeben kannst (der Skill basiert auf Browser-Automatisierung)
• du rein programmatischen Zugriff ohne jegliche UI-Interaktion benötigst

Für viele operative Workflows ist die Nutzung der bestehenden Slack Web-UI über agent-browser jedoch der schnellste Weg zum Einstieg.

---

How to Use

Installation and setup

1. Add the slack skill

Installiere den slack Skill in deiner Agent-Skill-Umgebung mit npx:

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

Dadurch werden die slack Skill-Definition und die zugehörigen Dateien (inklusive SKILL.md, References und Templates) aus dem vercel-labs/agent-browser Repository geladen.

2. Prepare a Slack browser session

Der slack Skill setzt voraus, dass Slack in einem Browser geöffnet ist oder geöffnet werden kann, den agent-browser steuern kann.

Typisches Setup-Muster:

# Option A: Mit einer bestehenden Browser-Session verbinden (Slack ist bereits geöffnet)
agent-browser connect 9222

# Option B: Slack direkt öffnen, falls es noch nicht läuft
agent-browser open https://app.slack.com

Der genaue Port (9222 oben) hängt davon ab, wie dein Browser mit aktiviertem Remote Debugging gestartet wird. Passe ihn an deine Umgebung an.

3. Confirm agent-browser access

Sobald die Verbindung steht oder Slack geöffnet ist, erstelle einen Snapshot, um zu prüfen, ob die Slack UI erreichbar ist:

agent-browser snapshot -i

Der Snapshot listet interaktive Elemente (mit Refs wie @e1, @e2 usw.), die du in späteren Kommandos anklicken, auslesen und automatisieren kannst.

---

Core workflow pattern

1. Connect or open Slack

Jede Session beginnt damit, die Slack Web-App anzubinden:

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

2. Discover elements with a snapshot

Nutze einen Snapshot, um zu sehen, was Slack aktuell anzeigt:

agent-browser snapshot -i

Du siehst Referenzen wie @e14 für den Activity Tab, @e13 für DMs oder eine Ref für den „More unreads“-Button. Diese Refs ermöglichen dir eine robuste, skriptbare Navigation.

3. Navigate to the relevant view

Klicke Tabs, klappe Sidebars auf oder öffne benötigte Bereiche:

# Beispiel: den Activity Tab öffnen
agent-browser click @e14
agent-browser wait 1000

Nutze weitere Snapshots nach der Navigation, um neue Elemente und Texte zu entdecken.

4. Extract information or take actions

Sobald du in der richtigen Ansicht bist, kannst du:

• Nachrichtentexte, Channel-Namen oder Zähler aus Snapshots auslesen
• in einzelne Channels oder DMs klicken
• scrollen und Screenshots für spätere Zusammenfassungen erfassen

Beispielmuster, um unreads zu prüfen:

agent-browser connect 9222
agent-browser snapshot -i
# In der Snapshot-Ausgabe nach "More unreads" suchen
agent-browser click @e21   # Beispiel-Ref für den "More unreads" Button
agent-browser screenshot slack-unreads.png

5. Capture evidence

Screenshots und strukturierte Notizen sind oft nötig für Slack-bezogene Audits, Incident-Reviews oder tägliche Standup-Reports.

Nutze:

agent-browser screenshot activity.png

und verwende anschließend das bereitgestellte Report-Template (siehe unten), um aus den Rohdaten einen standardisierten Report zu erstellen.

---

Common Slack automation tasks

Im Repository liegt references/slack-tasks.md, das Schritt-für-Schritt-Muster für häufige Workflows dokumentiert. Wichtige Aufgaben sind unter anderem:

Check all unread messages across Slack

Nutze dies, wenn du einen vollständigen Überblick über alle ungelesenen Inhalte brauchst.

High-Level-Schritte (Details in references/slack-tasks.md):

1. Mit Slack verbinden:

   agent-browser connect 9222
   

2. Den Activity Tab öffnen und prüfen, ob Slack keine unreads meldet.
3. Zum DMs Tab wechseln und Konversationen mit Unread-Badges identifizieren.
4. In der Channel-Sidebar "More unreads" aufklappen, um ungelesene Channels aufzulisten.
5. Screenshots jeder Ansicht aufnehmen und zu einer Zusammenfassung kombinieren.

Dieses Muster eignet sich ideal für eine geplante „check my Slack“-Automation oder einen Agenten, der sicherstellen soll, dass du auf dem aktuellen Stand bist, bevor er fortfährt.

Find all channels in a workspace

Wenn du ein Inventar aller Channels brauchst, auf die du Zugriff hast:

1. Verbinden und Snapshot erstellen:

   agent-browser connect 9222
   agent-browser snapshot -i
   

2. In der Sidebar den Bereich "Channels" finden.
3. Ihn aufklappen und einen Screenshot erstellen (z. B. all-channels.png).
4. Channel-Namen aus der Snapshot-Ausgabe auslesen.

Dies ist die Basis für Automatisierungen, die Channel-Strukturen erfassen, Aktivität kategorisieren oder Workspace-Overviews generieren.

---

Using templates and references

Reference playbooks

Der Ordner references/ stellt fertig formulierte Anleitungen für Slack Automatisierung bereit:

• references/slack-tasks.md – dokumentierte Muster für Unread-Checks, Channel-Listen und andere typische Workflows.

Du kannst diesen Inhalt als Playbook für deinen Agenten oder deine Skripte nutzen und die Sequenzen als Bausteine wiederverwenden.

Reporting templates

Der Ordner templates/ enthält ein strukturiertes Reporting-Template:

• templates/slack-report-template.md – eine Markdown-Reportvorlage für Slack-Analysen.

Sie umfasst Abschnitte zu:

• Unread-Zahlen nach Activity, DMs und Channels
• Listen ungelesener Channels und DMs
• Channel-Snapshot-Statistiken
• aktivsten Channels und wichtigen Konversationen

Nutze dieses Template, um zu standardisieren, wie deine Automatisierungen Slack-Ergebnisse für Stakeholder zusammenfassen.

---

Files to review first

Um den slack Skill zu verstehen und zu erweitern, solltest du zunächst diese Dateien im Repository öffnen:

• SKILL.md – zentrale Definition des slack Skills, Beschreibung und erlaubte Tools
• references/slack-tasks.md – detaillierte Task-Flows und Automatisierungsmuster
• templates/slack-report-template.md – Struktur für lesbare Slack Reports

Diese Dateien zeigen die vorgesehenen Nutzungsmuster, ohne dass du das gesamte Repo durchsuchen musst.

---

FAQ

What is the slack skill in agent-browser?

Der slack Skill ist ein wiederverwendbares Automatisierungsprofil, das agent-browser beibringt, wie es über die Slack Web-UI mit Slack Workspaces interagieren soll. Er konzentriert sich auf Aufgaben wie das Prüfen von Unreads, das Navigieren zwischen Channels und DMs, Suchen und Datenextraktion – alles per Browser-Automatisierung statt über direkte Slack APIs.

How do I install the slack skill?

Installiere ihn via npx aus dem vercel-labs/agent-browser Repository:

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

Stelle nach der Installation sicher, dass du agent-browser ausführen und eine Verbindung zu einem Browser herstellen kannst, in dem Slack geöffnet ist oder geöffnet werden kann.

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

Nein. Der slack Skill interagiert mit der Slack Web-Anwendung in deinem Browser. Solange du in diesem Browser bei Slack eingeloggt bist und agent-browser ihn steuern kann, kann der Skill seine Aufgaben mit deinen bestehenden Zugriffsrechten und Berechtigungen ausführen.

Can this skill read all messages in my workspace?

Der Skill kann nur das sehen, was dein eingeloggter Slack Account über die Weboberfläche sehen kann. Er umgeht keine Berechtigungen. Er eignet sich am besten für operative Checks (Unreads, Channel-Listen, jüngste Aktivität), nicht für vollständige historische Exports aller Nachrichten.

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

Refs wie @e14 werden von jedem agent-browser snapshot neu vergeben und können sich zwischen Sessions ändern oder wenn Slack seine UI aktualisiert. Die Muster in references/slack-tasks.md zeigen, wie du in der Snapshot-Ausgabe nach Labels wie "Activity", "DMs" oder "More unreads" suchst und dann dynamisch die entsprechende Ref verwendest, statt feste Nummern zu hardcoden.

Is the slack skill suitable for headless or server environments?

Du kannst ihn überall einsetzen, wo du einen Browser mit Remote Debugging betreiben kannst, zu dem agent-browser eine Verbindung aufbauen kann. Wenn deine Umgebung überhaupt keinen Browser ausführen oder erreichen kann, ist dieser browserbasierte Skill nicht geeignet und eine API-basierte Integration ist wahrscheinlich passender.

What categories of automation does this skill support?

Der slack Skill ist in erster Linie ein workflow-automation Tool und in zweiter Linie ein browser-automation Tool. Er eignet sich gut für CLI- oder Agent-Workflows, die:

• den Slack-Status prüfen müssen, bevor andere Jobs laufen
• Informationen aus Slack als Teil von Incident- oder Support-Prozessen sammeln
• standardisierte Slack Aktivitätsreports aus Templates erzeugen

Where can I learn the detailed task flows?

Öffne die Files-Ansicht für den Skill und sieh dir an:

• SKILL.md für die High-Level-Definition und Quickstart-Beispiele
• references/slack-tasks.md für Schritt-für-Schritt-Anleitungen zu einzelnen Tasks
• templates/slack-report-template.md für die Reporting-Struktur

Diese Dokumente liefern gemeinsam genug Details, damit du entscheiden kannst, wie du den slack Skill an deine eigenen Workflows und Rahmenbedingungen anpasst.