slack

Overview

What the slack skill does

Kỹ năng slack tự động hóa các workspace Slack thật bằng cách điều khiển Slack web app trong trình duyệt của bạn. Nó dùng agent-browser để điều khiển một phiên Slack đã đăng nhập sẵn, cho phép bạn:

• Kiểm tra kênh và DM nào đang có tin chưa đọc
• Di chuyển trong giao diện Slack (Activity, DMs, channels, search)
• Trích xuất dữ liệu có cấu trúc từ các view trong Slack
• Chụp ảnh màn hình làm bằng chứng cho báo cáo
• Đưa các bước kiểm tra Slack lặp lại vào những workflow tự động lớn hơn

Vì chạy trực tiếp trên giao diện web Slack đang hoạt động, kỹ năng này tận dụng chính quyền truy cập, bố cục workspace và cơ chế đăng nhập hiện có của bạn.

Who this skill is for

Hãy dùng kỹ năng slack nếu bạn:

• Theo dõi nhiều workspace Slack và cần các lần kiểm tra trạng thái nhanh, lặp lại được
• Vận hành các workflow vận hành, hỗ trợ, hoặc xử lý sự cố dựa nhiều vào tin nhắn trong Slack
• Muốn một agent hoặc job CLI quét Slack rồi tạo tóm tắt hoặc báo cáo
• Ưa thích cách tự động hóa qua trình duyệt (không cần tạo Slack app riêng hoặc quản lý API token)

Đây là lựa chọn phù hợp cho kỹ sư, SRE/ops, nhà phân tích và bất kỳ ai đang xây dựng workflow automation hoặc browser automation trên Slack.

What problems it solves

Việc tự tay kiểm tra Slack vừa chậm vừa dễ sót. Kỹ năng slack giúp bạn:

• Tìm ra một cách hệ thống tất cả kênh và DM đang chưa đọc
• Thu thập bằng chứng (screenshot, snapshot) cho mục đích tuân thủ hoặc rà soát sự cố
• Tạo báo cáo hoạt động Slack nhất quán từ các template có sẵn
• Tái sử dụng các pattern điều hướng quen thuộc thay vì phải “học lại” UI mỗi lần

Nếu bạn thường nghĩ kiểu “check my Slack” hoặc “show me all channels with unreads” như một phần của script hay lần chạy agent, kỹ năng này được thiết kế chính xác cho nhu cầu đó.

When slack is not a good fit

Hãy cân nhắc hướng khác nếu:

• Bạn cần xuất dữ liệu khối lượng lớn, lịch sử dài hoặc phân tích chuyên sâu (Slack API hoặc export sẽ phù hợp hơn)
• Bạn không thể chạy trình duyệt hoặc mở cổng debug (kỹ năng này phụ thuộc vào browser automation)
• Bạn yêu cầu truy cập lập trình hoàn toàn không đụng tới UI

Với đa số workflow vận hành, tận dụng UI web Slack hiện có thông qua agent-browser thường là cách nhanh nhất để bắt đầu.

---

How to Use

Installation and setup

1. Add the slack skill

Cài kỹ năng slack vào môi trường skills của agent bằng npx:

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

Lệnh này tải definition của kỹ năng slack và các file hỗ trợ (bao gồm SKILL.md, tài liệu tham chiếu và template) từ repository vercel-labs/agent-browser.

2. Prepare a Slack browser session

Kỹ năng slack giả định bạn đã mở Slack hoặc có Slack chạy trong một trình duyệt mà agent-browser có thể điều khiển.

Mẫu thiết lập phổ biến:

# Option A: Connect to an existing browser session (Slack already open)
agent-browser connect 9222

# Option B: Open Slack directly if it is not running yet
agent-browser open https://app.slack.com

Port cụ thể (9222 phía trên) phụ thuộc vào cách bạn khởi động trình duyệt với chế độ remote debugging. Hãy chỉnh lại cho khớp với môi trường của bạn.

3. Confirm agent-browser access

Sau khi đã connect hoặc open, hãy chụp một snapshot để xác nhận UI Slack truy cập được:

agent-browser snapshot -i

Snapshot sẽ liệt kê các phần tử tương tác (có ref như @e1, @e2, …) mà bạn có thể click, đọc và tự động hóa trong các lệnh tiếp theo.

---

Core workflow pattern

1. Connect or open Slack

Mỗi phiên làm việc bắt đầu bằng việc gắn vào Slack web app:

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

2. Discover elements with a snapshot

Dùng snapshot để xem Slack hiện đang hiển thị gì:

agent-browser snapshot -i

Bạn sẽ thấy các ref như @e14 cho tab Activity, @e13 cho DMs, hoặc một ref cho nút “More unreads”. Những ref này cho phép bạn script điều hướng một cách ổn định.

3. Navigate to the relevant view

Click tab, mở rộng sidebar hoặc mở các mục cần thiết:

# Example: open the Activity tab
agent-browser click @e14
agent-browser wait 1000

Sau mỗi bước điều hướng, hãy tạo thêm snapshot để phát hiện các phần tử và text mới.

4. Extract information or take actions

Khi đã ở đúng view, bạn có thể:

• Đọc nội dung tin nhắn, tên kênh hoặc số lượng từ snapshot
• Click vào từng kênh hoặc DM cụ thể
• Cuộn và chụp screenshot để dùng cho bước tóm tắt sau

Ví dụ pattern kiểm tra tin chưa đọc:

agent-browser connect 9222
agent-browser snapshot -i
# Look for "More unreads" in the snapshot output
agent-browser click @e21   # Example ref for the "More unreads" button
agent-browser screenshot slack-unreads.png

5. Capture evidence

Screenshot và ghi chú có cấu trúc thường cần thiết cho audit liên quan tới Slack, review sự cố hoặc tóm tắt daily standup.

Dùng:

agent-browser screenshot activity.png

và tham chiếu template báo cáo đi kèm (xem bên dưới) để chuyển kết quả thô thành báo cáo chuẩn hóa.

---

Common Slack automation tasks

Repository này bao gồm references/slack-tasks.md, tài liệu hóa từng bước cho các workflow thường gặp. Một số tác vụ chính:

Check all unread messages across Slack

Dùng khi bạn cần cái nhìn đầy đủ về mọi thứ mình chưa đọc.

Các bước tổng quát (xem chi tiết trong references/slack-tasks.md):

1. Connect tới Slack:

   agent-browser connect 9222
   

2. Mở tab Activity và kiểm tra xem Slack có báo là không còn tin chưa đọc hay không.
3. Chuyển sang tab DMs và xác định các hội thoại có badge chưa đọc.
4. Mở rộng mục "More unreads" trong channels sidebar để liệt kê các kênh chưa đọc.
5. Chụp screenshot từng view và tổng hợp lại thành một bản tóm tắt.

Pattern này rất lý tưởng cho các automation chạy theo lịch kiểu "check my Slack" hoặc một agent cần xác nhận bạn đã cập nhật hết trước khi tiếp tục công việc khác.

Find all channels in a workspace

Dùng khi bạn cần một bản liệt kê các kênh mình có quyền truy cập trong một workspace:

1. Connect và snapshot:

   agent-browser connect 9222
   agent-browser snapshot -i
   

2. Xác định phần "Channels" trong sidebar.
3. Click để mở rộng và chụp screenshot (ví dụ all-channels.png).
4. Trích tên kênh từ output của snapshot.

Pattern này là nền tảng cho những automation lập bản đồ cấu trúc kênh, phân loại hoạt động hoặc tạo overview cho workspace.

---

Using templates and references

Reference playbooks

Thư mục references/ cung cấp các hướng dẫn sẵn cho Slack automation:

• references/slack-tasks.md – mô tả chi tiết pattern cho việc kiểm tra tin chưa đọc, liệt kê kênh và các workflow phổ biến khác.

Bạn có thể xem đây như playbook cho agent hoặc script của mình, tái sử dụng các chuỗi bước này như những block xây dựng.

Reporting templates

Thư mục templates/ chứa một template báo cáo có cấu trúc:

• templates/slack-report-template.md – dàn ý báo cáo Markdown cho phân tích Slack.

Template gồm các phần:

• Số lượng chưa đọc theo Activity, DMs và channels
• Danh sách kênh và DM chưa đọc
• Thống kê snapshot theo kênh
• Các kênh hoạt động nhiều nhất và hội thoại quan trọng

Hãy dùng template này để tiêu chuẩn hóa cách automation của bạn tổng hợp kết quả Slack cho các bên liên quan.

---

Files to review first

Để hiểu và mở rộng kỹ năng slack, hãy mở các file sau trong repository:

• SKILL.md – định nghĩa chính của kỹ năng slack, mô tả và các công cụ được phép dùng
• references/slack-tasks.md – flow tác vụ chi tiết và các pattern tự động hóa
• templates/slack-report-template.md – cấu trúc cho báo cáo Slack dễ đọc với con người

Những file này thể hiện rõ cách sử dụng dự kiến mà không cần phải đọc toàn bộ repo.

---

FAQ

What is the slack skill in agent-browser?

Kỹ năng slack là một profile automation có thể tái sử dụng, giúp agent-browser biết cách tương tác với các workspace Slack thông qua Slack web UI. Nó tập trung vào các tác vụ như kiểm tra tin chưa đọc, điều hướng kênh và DM, tìm kiếm và trích xuất dữ liệu, tất cả đều thông qua browser automation thay vì dùng trực tiếp Slack API.

How do I install the slack skill?

Cài đặt bằng npx từ repository vercel-labs/agent-browser:

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

Sau khi cài, hãy đảm bảo bạn chạy được agent-browser và kết nối được tới một trình duyệt nơi Slack đang mở (hoặc có thể được mở).

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

Không. Kỹ năng slack tương tác với web application của Slack trong trình duyệt. Chỉ cần bạn đã đăng nhập Slack trong trình duyệt đó và agent-browser điều khiển được, kỹ năng có thể thực hiện tác vụ dựa trên quyền truy cập hiện có của bạn.

Can this skill read all messages in my workspace?

Kỹ năng chỉ nhìn thấy những gì tài khoản Slack đã đăng nhập của bạn thấy được qua giao diện web. Nó không vượt qua giới hạn quyền. Kỹ năng phù hợp nhất cho các kiểm tra vận hành (tin chưa đọc, danh sách kênh, hoạt động gần đây) hơn là việc export toàn bộ lịch sử mọi tin nhắn.

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

Các ref như @e14 được tạo ra từ mỗi lệnh agent-browser snapshot và có thể thay đổi giữa các phiên hoặc khi Slack cập nhật UI. Các pattern trong references/slack-tasks.md hướng dẫn cách tìm label như "Activity", "DMs" hoặc "More unreads" trong output snapshot rồi dùng ref tương ứng một cách động, thay vì hard-code con số.

Is the slack skill suitable for headless or server environments?

Có thể dùng ở bất kỳ đâu bạn chạy được trình duyệt với remote debugging mà agent-browser kết nối được. Nếu môi trường của bạn hoàn toàn không thể chạy hoặc truy cập trình duyệt, kỹ năng dựa trên trình duyệt này sẽ không phù hợp và bạn nên cân nhắc tích hợp dựa trên API.

What categories of automation does this skill support?

Kỹ năng slack chủ yếu là công cụ workflow-automation và thứ cấp là browser-automation. Nó rất phù hợp với các workflow do CLI hoặc agent điều khiển, cần:

• Kiểm tra trạng thái Slack trước khi chạy job khác
• Thu thập thông tin từ Slack như một phần của quy trình xử lý sự cố hoặc hỗ trợ khách hàng
• Tạo báo cáo hoạt động Slack chuẩn hóa từ các template

Where can I learn the detailed task flows?

Mở phần Files của skill và xem:

• SKILL.md để nắm định nghĩa tổng quan và ví dụ quick start
• references/slack-tasks.md cho hướng dẫn chi tiết theo từng tác vụ
• templates/slack-report-template.md cho cấu trúc báo cáo

Bộ tài liệu này đủ chi tiết để bạn quyết định nên điều chỉnh kỹ năng slack như thế nào cho phù hợp với workflow và ràng buộc của riêng mình.