slack

Overview

What the slack skill does

A skill slack automatiza workspaces Slack reais controlando o app web do Slack no seu navegador. Ela usa o agent-browser para controlar uma sessão do Slack já aberta, permitindo que você:

• Veja quais canais e DMs têm mensagens não lidas
• Navegue pela interface do Slack (Activity, DMs, canais, busca)
• Extraia dados estruturados das telas do Slack
• Capture screenshots como evidência para relatórios
• Transforme verificações recorrentes do Slack em partes de fluxos de automação maiores

Como roda em cima da interface web ao vivo do Slack, essa skill respeita suas permissões atuais, o layout do workspace e a autenticação já em uso.

Who this skill is for

Use a skill slack se você:

• Monitora vários workspaces Slack e precisa de checagens rápidas e repetíveis de status
• Roda fluxos de operações, suporte ou incidentes que dependem de mensagens no Slack
• Quer que um agent ou job em CLI analise o Slack e produza resumos ou relatórios
• Prefere automação via navegador (sem precisar criar app Slack próprio nem gerenciar API tokens)

É uma boa opção para engenheiros, SRE/ops, analistas e qualquer pessoa que esteja construindo workflow automation ou browser automation em cima do Slack.

What problems it solves

Checar o Slack manualmente é lento e sujeito a erros. A skill slack ajuda você a:

• Identificar de forma sistemática todos os canais e DMs com mensagens não lidas
• Coletar evidências (screenshots, snapshots) para compliance ou revisões de incidentes
• Gerar relatórios consistentes de atividade no Slack a partir de templates
• Reaproveitar padrões de navegação em vez de redescobrir a interface toda vez

Se você se pega pensando “verificar meu Slack” ou “mostrar todos os canais com não lidas” como parte de um script ou execução de agent, essa skill foi feita para isso.

When slack is not a good fit

Considere outras abordagens se:

• Você precisa de exportações de grandes volumes de dados ou análises históricas profundas (APIs ou exports do Slack podem ser melhores)
• Não consegue rodar um navegador ou expor uma porta de debugging (a skill depende de automação de navegador)
• Precisa de acesso programático sem qualquer interação com UI

Para muitos fluxos operacionais, porém, usar a interface web existente do Slack via agent-browser é a maneira mais rápida de começar.

---

How to Use

Installation and setup

1. Add the slack skill

Instale a skill slack no ambiente de skills do seu agent usando npx:

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

Esse comando baixa a definição da skill slack e seus arquivos de suporte (incluindo SKILL.md, referências e templates) do repositório vercel-labs/agent-browser.

2. Prepare a Slack browser session

A skill slack assume que o Slack esteja aberto ou disponível em um navegador que o agent-browser possa controlar.

Padrão comum de configuração:

# Option A: conectar a uma sessão de navegador existente (Slack já aberto)
agent-browser connect 9222

# Option B: abrir o Slack diretamente se ainda não estiver rodando
agent-browser open https://app.slack.com

A porta exata (9222 acima) depende de como o navegador foi iniciado com remote debugging habilitado. Ajuste para corresponder ao seu ambiente.

3. Confirm agent-browser access

Depois de conectar ou abrir, capture um snapshot para verificar se a interface do Slack está acessível:

agent-browser snapshot -i

O snapshot lista elementos interativos (com refs como @e1, @e2 etc.) que você pode clicar, ler e automatizar em comandos posteriores.

---

Core workflow pattern

1. Connect or open Slack

Toda sessão começa anexando ao app web do Slack:

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

2. Discover elements with a snapshot

Use um snapshot para ver o que o Slack está exibindo no momento:

agent-browser snapshot -i

Você verá referências como @e14 para a aba Activity, @e13 para DMs ou uma ref para o botão “More unreads”. Essas refs permitem que você roteirize a navegação de forma confiável.

3. Navigate to the relevant view

Clique em abas, expanda sidebars ou abra seções conforme necessário:

# Exemplo: abrir a aba Activity
agent-browser click @e14
agent-browser wait 1000

Use novos snapshots depois de navegar para descobrir novos elementos e textos.

4. Extract information or take actions

Quando estiver na visão certa, você pode:

• Ler texto de mensagens, nomes de canais ou contagens a partir dos snapshots
• Clicar em canais ou DMs específicos
• Rolar a tela e capturar screenshots para sumarização posterior

Exemplo de padrão para checar não lidas:

agent-browser connect 9222
agent-browser snapshot -i
# Procure por "More unreads" na saída do snapshot
agent-browser click @e21   # Ref de exemplo para o botão "More unreads"
agent-browser screenshot slack-unreads.png

5. Capture evidence

Screenshots e anotações estruturadas costumam ser necessárias para auditorias relacionadas ao Slack, revisões de incidentes ou resumos diários (standups).

Use:

agent-browser screenshot activity.png

e utilize o template de relatório fornecido (veja abaixo) para transformar os achados brutos em um relatório padronizado.

---

Common Slack automation tasks

O repositório inclui references/slack-tasks.md, que documenta passo a passo padrões para fluxos de trabalho frequentes. Algumas tarefas principais incluem:

Check all unread messages across Slack

Use quando você quiser uma visão completa de tudo o que ainda não foi lido.

Passos em alto nível (veja references/slack-tasks.md para detalhes completos):

1. Conecte ao Slack:

   agent-browser connect 9222
   

2. Abra a aba Activity e verifique se o Slack indica ausência de não lidas.
3. Mude para a aba DMs e identifique conversas com badges de não lidas.
4. Expanda "More unreads" na sidebar de canais para listar os canais não lidos.
5. Capture screenshots de cada visão e combine tudo em um resumo.

Esse padrão é ideal para uma automação agendada de "check my Slack" ou para um agent que precise confirmar que você está em dia antes de seguir para a próxima etapa.

Find all channels in a workspace

Quando você precisa de um inventário de canais aos quais tem acesso:

1. Conecte e faça um snapshot:

   agent-browser connect 9222
   agent-browser snapshot -i
   

2. Localize a seção "Channels" na sidebar.
3. Clique para expandir e capture um screenshot (por exemplo, all-channels.png).
4. Extraia os nomes dos canais a partir da saída do snapshot.

Esse fluxo serve de base para automações que mapeiam a estrutura de canais, categorizam atividade ou geram visões gerais do workspace.

---

Using templates and references

Reference playbooks

A pasta references/ oferece instruções prontas para automação do Slack:

• references/slack-tasks.md – padrões documentados para checar não lidas, listar canais e outros fluxos comuns.

Você pode tratar esse conteúdo como um playbook para seus agents ou scripts, reutilizando as sequências como blocos de construção.

Reporting templates

A pasta templates/ contém um template estruturado de relatório:

• templates/slack-report-template.md – um outline de relatório em Markdown para análise do Slack.

Ele inclui seções para:

• Contagem de não lidas por Activity, DMs e canais
• Listas de canais e DMs não lidos
• Estatísticas de snapshots de canais
• Canais mais ativos e conversas-chave

Use esse template para padronizar como suas automações resumem achados do Slack para stakeholders.

---

Files to review first

Para entender e estender a skill slack, abra estes arquivos no repositório:

• SKILL.md – definição principal da skill slack, descrição e ferramentas permitidas
• references/slack-tasks.md – fluxos de tarefas detalhados e padrões de automação
• templates/slack-report-template.md – estrutura para relatórios legíveis por humanos sobre o Slack

Esses arquivos mostram os padrões de uso pretendidos sem que você precise examinar o repositório inteiro.

---

FAQ

What is the slack skill in agent-browser?

A skill slack é um perfil de automação reutilizável que ensina o agent-browser a interagir com workspaces Slack via interface web do Slack. Ela foca em tarefas como checar não lidas, navegar por canais e DMs, buscar e extrair dados, tudo por automação de navegador em vez de usar diretamente as APIs do Slack.

How do I install the slack skill?

Instale via npx a partir do repositório vercel-labs/agent-browser:

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

Depois da instalação, verifique se você consegue rodar o agent-browser e conectar a um navegador em que o Slack esteja aberto ou possa ser aberto.

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

Não. A skill slack interage com a aplicação web do Slack no seu navegador. Enquanto você estiver logado no Slack nesse navegador e o agent-browser conseguir controlá-lo, a skill consegue executar as tarefas usando seu acesso e permissões atuais.

Can this skill read all messages in my workspace?

A skill só consegue ver o que a sua conta logada no Slack consegue ver pela interface web. Ela não contorna permissões. É mais indicada para checagens operacionais (não lidas, listas de canais, atividade recente) do que para exports históricos completos de todas as mensagens.

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

Refs como @e14 são geradas a cada agent-browser snapshot e podem mudar entre sessões ou conforme o Slack atualiza sua UI. Os padrões em references/slack-tasks.md mostram como procurar labels como "Activity", "DMs" ou "More unreads" na saída do snapshot e então usar dinamicamente a ref correspondente em vez de fixar números.

Is the slack skill suitable for headless or server environments?

Ela pode ser usada em qualquer ambiente em que você consiga rodar um navegador com remote debugging ao qual o agent-browser possa se conectar. Se o seu ambiente não consegue rodar ou acessar um navegador de forma alguma, essa skill baseada em navegador não será adequada, e uma integração baseada em API pode ser mais apropriada.

What categories of automation does this skill support?

A skill slack é principalmente uma ferramenta de workflow-automation e, em segundo plano, de browser-automation. Ela é bem adequada para fluxos acionados via CLI ou agents que precisem:

• Checar o estado do Slack antes de executar outros jobs
• Coletar informações do Slack como parte de processos de incidentes ou suporte
• Produzir relatórios padronizados de atividade no Slack a partir de templates

Where can I learn the detailed task flows?

Abra a visualização de arquivos (Files) da skill e consulte:

• SKILL.md para a definição em alto nível e exemplos de quick start
• references/slack-tasks.md para instruções passo a passo por tarefa
• templates/slack-report-template.md para a estrutura de relatórios

Esses documentos, em conjunto, fornecem detalhes suficientes para você decidir como adaptar a skill slack aos seus próprios fluxos de trabalho e restrições.