slack

Overview

What the slack skill does

La habilidad slack automatiza espacios de trabajo reales de Slack controlando la aplicación web de Slack en tu navegador. Usa agent-browser para manejar una sesión existente de Slack, de modo que puedas:

• Ver qué canales y DMs tienen mensajes sin leer
• Navegar por la interfaz de Slack (Activity, DMs, channels, search)
• Extraer datos estructurados de las vistas de Slack
• Capturar capturas de pantalla como evidencia para informes
• Integrar comprobaciones recurrentes de Slack en flujos de automatización más amplios

Como se ejecuta sobre la interfaz web en vivo de Slack, esta habilidad funciona con tus permisos actuales, el diseño de tu espacio de trabajo y tu autenticación existente.

Who this skill is for

Usa la habilidad slack si:

• Supervisas varios espacios de trabajo de Slack y necesitas comprobaciones de estado rápidas y repetibles
• Gestionas operaciones, soporte o flujos de gestión de incidentes que dependen de mensajes en Slack
• Quieres que un agente o un trabajo desde la CLI revise Slack y genere resúmenes o informes
• Prefieres automatización basada en navegador (sin tener que crear apps personalizadas de Slack ni gestionar tokens de API)

Es una buena opción para ingenieros, SRE/ops, analistas y cualquiera que esté construyendo workflow automation o browser automation sobre Slack.

What problems it solves

Revisar Slack manualmente es lento y propenso a errores. La habilidad slack te ayuda a:

• Identificar de forma sistemática todos los canales y DMs con mensajes sin leer
• Capturar evidencia (capturas de pantalla, snapshots) para cumplimiento o revisiones de incidentes
• Generar informes consistentes de actividad en Slack a partir de plantillas
• Reutilizar patrones de navegación comunes en lugar de reaprender la interfaz cada vez

Si a menudo piensas “revisa mi Slack” o “muéstrame todos los canales con mensajes sin leer” como parte de un script o ejecución de un agente, esta habilidad está pensada para eso.

When slack is not a good fit

Plantéate otros enfoques si:

• Necesitas exportaciones de datos masivas o analítica histórica en profundidad (pueden ser más adecuados las APIs o las exportaciones de Slack)
• No puedes ejecutar un navegador ni exponer un puerto de depuración (la habilidad depende de la automatización de navegador)
• Requieres acceso puramente programático sin ninguna interacción con la interfaz

Para muchos flujos operativos, sin embargo, usar la interfaz web existente de Slack mediante agent-browser es la forma más rápida de empezar.

---

How to Use

Installation and setup

1. Add the slack skill

Instala la habilidad slack en el entorno de habilidades de tu agente usando npx:

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

Esto descarga la definición de la habilidad slack y sus archivos de soporte (incluidos SKILL.md, referencias y plantillas) desde el repositorio vercel-labs/agent-browser.

2. Prepare a Slack browser session

La habilidad slack asume que tienes Slack abierto o disponible en un navegador que agent-browser pueda controlar.

Patrón de configuración habitual:

# Opción A: Conectarse a una sesión de navegador existente (Slack ya está abierto)
agent-browser connect 9222

# Opción B: Abrir Slack directamente si aún no se está ejecutando
agent-browser open https://app.slack.com

El puerto exacto (9222 en el ejemplo) depende de cómo inicies tu navegador con la depuración remota activada. Ajústalo para que coincida con tu entorno.

3. Confirm agent-browser access

Una vez conectado o abierto, captura un snapshot para verificar que la interfaz de Slack es accesible:

agent-browser snapshot -i

El snapshot enumerará elementos interactivos (con refs como @e1, @e2, etc.) que podrás hacer clic, leer y automatizar en comandos posteriores.

---

Core workflow pattern

1. Connect or open Slack

Cada sesión comienza conectándose a la aplicación web de Slack:

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

2. Discover elements with a snapshot

Usa un snapshot para ver qué está mostrando Slack en ese momento:

agent-browser snapshot -i

Verás referencias como @e14 para la pestaña Activity, @e13 para DMs, o una ref para el botón “More unreads”. Estas refs te permiten automatizar la navegación de forma fiable.

3. Navigate to the relevant view

Haz clic en pestañas, expande barras laterales u abre secciones según sea necesario:

# Ejemplo: abrir la pestaña Activity
agent-browser click @e14
agent-browser wait 1000

Usa snapshots adicionales después de navegar para descubrir nuevos elementos y textos.

4. Extract information or take actions

Una vez que estés en la vista adecuada, puedes:

• Leer texto de mensajes, nombres de canales o contadores desde los snapshots
• Entrar en canales o DMs concretos
• Desplazarte y capturar capturas de pantalla para resumir más tarde

Patrón de ejemplo para revisar mensajes sin leer:

agent-browser connect 9222
agent-browser snapshot -i
# Busca "More unreads" en la salida del snapshot
agent-browser click @e21   # Ref de ejemplo para el botón "More unreads"
agent-browser screenshot slack-unreads.png

5. Capture evidence

Las capturas de pantalla y notas estructuradas suelen ser necesarias para auditorías relacionadas con Slack, revisiones de incidentes o resúmenes diarios (daily standups).

Usa:

agent-browser screenshot activity.png

y consulta la plantilla de informe incluida (ver más abajo) para convertir los hallazgos en un informe estandarizado.

---

Common Slack automation tasks

El repositorio incluye references/slack-tasks.md, donde se documentan patrones paso a paso para flujos de trabajo frecuentes. Algunas tareas clave son:

Check all unread messages across Slack

Úsalo cuando quieras una visión completa de todo lo que aún no has leído.

Pasos generales (consulta references/slack-tasks.md para el detalle completo):

1. Conéctate a Slack:

   agent-browser connect 9222
   

2. Abre la pestaña Activity y comprueba si Slack indica que no hay elementos sin leer.
3. Cambia a la pestaña DMs e identifica las conversaciones con indicadores de mensajes sin leer.
4. Expande "More unreads" en la barra lateral de canales para listar los canales con mensajes pendientes.
5. Captura capturas de pantalla de cada vista y combínalas en un resumen.

Este patrón es ideal para una automatización programada de "check my Slack" o para un agente que necesite confirmar que estás al día antes de continuar.

Find all channels in a workspace

Cuando necesitas un inventario de los canales a los que tienes acceso:

1. Conéctate y genera un snapshot:

   agent-browser connect 9222
   agent-browser snapshot -i
   

2. Localiza la sección "Channels" en la barra lateral.
3. Haz clic para expandirla y captura una captura de pantalla (por ejemplo all-channels.png).
4. Extrae los nombres de los canales a partir de la salida del snapshot.

Esto sirve de base para automatizaciones que mapean la estructura de canales, categorizan actividad o generan vistas generales del espacio de trabajo.

---

Using templates and references

Reference playbooks

La carpeta references/ proporciona instrucciones listas para usar para automatizar Slack:

• references/slack-tasks.md – patrones documentados para revisar mensajes sin leer, listar canales y otros flujos de trabajo habituales.

Puedes tratarlo como un playbook para tu agente o scripts, reutilizando las secuencias como bloques de construcción.

Reporting templates

La carpeta templates/ contiene una plantilla estructurada de informe:

• templates/slack-report-template.md – un esquema de informe en Markdown para análisis de Slack.

Incluye secciones para:

• Recuentos de elementos sin leer por Activity, DMs y channels
• Listas de canales y DMs con mensajes sin leer
• Estadísticas de snapshots de canales
• Canales más activos y conversaciones clave

Usa esta plantilla para estandarizar cómo tus automatizaciones resumen los hallazgos de Slack para las partes interesadas.

---

Files to review first

Para entender y ampliar la habilidad slack, abre estos archivos del repositorio:

• SKILL.md – definición principal de la habilidad slack, descripción y herramientas permitidas
• references/slack-tasks.md – flujos de tareas detallados y patrones de automatización
• templates/slack-report-template.md – estructura para informes legibles por personas sobre Slack

Estos archivos muestran los patrones de uso previstos sin necesidad de revisar todo el repositorio.

---

FAQ

What is the slack skill in agent-browser?

La habilidad slack es un perfil de automatización reutilizable que enseña a agent-browser cómo interactuar con espacios de trabajo de Slack a través de la interfaz web de Slack. Se centra en tareas como revisar mensajes sin leer, navegar por canales y DMs, buscar y extraer datos, todo mediante automatización de navegador en lugar de APIs directas de Slack.

How do I install the slack skill?

Instálala mediante npx desde el repositorio vercel-labs/agent-browser:

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

Después de la instalación, asegúrate de que puedes ejecutar agent-browser y conectarte a un navegador donde Slack esté abierto o se pueda abrir.

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

No. La habilidad slack interactúa con la aplicación web de Slack en tu navegador. Mientras tu sesión de Slack esté iniciada en ese navegador y agent-browser pueda controlarlo, la habilidad podrá ejecutar sus tareas usando tu acceso y permisos existentes.

Can this skill read all messages in my workspace?

La habilidad solo puede ver lo que tu cuenta de Slack, ya autenticada, puede ver a través de la interfaz web. No evita ni amplía permisos. Es más adecuada para comprobaciones operativas (mensajes sin leer, listas de canales, actividad reciente) que para exportaciones históricas completas de todos los mensajes.

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

Las refs como @e14 se generan en cada agent-browser snapshot y pueden cambiar entre sesiones o cuando Slack actualiza su interfaz. Los patrones en references/slack-tasks.md muestran cómo buscar etiquetas como "Activity", "DMs" o "More unreads" en la salida del snapshot y luego usar dinámicamente la ref correspondiente en lugar de codificar números fijos.

Is the slack skill suitable for headless or server environments?

Se puede usar siempre que puedas ejecutar un navegador con depuración remota al que agent-browser pueda conectarse. Si tu entorno no puede ejecutar ni acceder a un navegador, esta habilidad basada en navegador no será adecuada y probablemente encaje mejor una integración basada en API.

What categories of automation does this skill support?

La habilidad slack es principalmente una herramienta de workflow-automation y, en segundo lugar, de browser-automation. Es muy adecuada para flujos impulsados por CLI o por agentes que necesiten:

• Revisar el estado de Slack antes de ejecutar otros trabajos
• Recopilar información de Slack como parte de procesos de incidentes o soporte
• Generar informes estandarizados de actividad en Slack a partir de plantillas

Where can I learn the detailed task flows?

Abre la vista de archivos de la habilidad y revisa:

• SKILL.md para la definición de alto nivel y ejemplos de inicio rápido
• references/slack-tasks.md para instrucciones detalladas tarea por tarea
• templates/slack-report-template.md para la estructura de informes

Estos documentos en conjunto ofrecen suficiente detalle para decidir cómo adaptar la habilidad slack a tus propios flujos de trabajo y restricciones.