slack

Overview

What the slack skill does

slack 스킬은 브라우저에서 Slack 웹 앱을 직접 조작해 실제 Slack 워크스페이스를 자동화합니다. agent-browser를 사용해 기존 Slack 세션을 제어하고, 다음과 같은 작업을 수행할 수 있습니다:

• 읽지 않은 메시지가 있는 채널과 DM 확인
• Slack UI 탐색(활동, DM, 채널, 검색)
• Slack 뷰에서 구조화된 데이터 추출
• 리포트를 위한 스크린샷 캡처
• 반복 가능한 Slack 점검을 더 큰 자동화 워크플로에 포함

실제 Slack 웹 인터페이스를 그대로 사용하기 때문에, 이 스킬은 사용자의 기존 권한, 워크스페이스 레이아웃, 인증 상태를 그대로 활용합니다.

Who this skill is for

다음과 같은 경우 slack 스킬 사용을 권장합니다:

• 여러 개의 Slack 워크스페이스를 모니터링하며 빠르고 반복 가능한 상태 점검이 필요할 때
• 운영, 지원, 인시던트 대응 워크플로가 Slack 메시지에 크게 의존할 때
• 에이전트나 CLI job이 Slack을 스캔해 요약이나 리포트를 만들어야 할 때
• 별도 Slack 앱이나 API 토큰 관리 없이 브라우저 자동화를 선호할 때

엔지니어, SRE/운영 담당자, 분석가, 그리고 Slack 기반으로 워크플로 자동화나 브라우저 자동화를 구축하는 모든 사용자에게 적합합니다.

What problems it solves

수동으로 Slack을 확인하는 작업은 느리고 실수가 생기기 쉽습니다. slack 스킬은 다음과 같은 문제를 해결하는 데 도움이 됩니다:

• 읽지 않은 채널과 DM을 체계적으로 모두 식별
• 컴플라이언스나 인시던트 리뷰를 위한 증적(스크린샷, 스냅샷) 캡처
• 템플릿 기반의 일관된 Slack 활동 리포트 생성
• 매번 UI를 다시 익히는 대신 공통 네비게이션 패턴을 재사용

스크립트나 에이전트를 만들면서 "내 Slack 상태를 확인해 줘" 또는 "읽지 않은 채널만 모두 보여줘" 같은 요구가 반복된다면, 이 스킬이 그런 작업을 위해 설계되어 있습니다.

When slack is not a good fit

다음과 같은 경우에는 다른 접근 방식을 고려하세요:

• 대량 데이터 내보내기나 장기 이력 분석이 필요할 때(Slack API나 공식 내보내기가 더 적합할 수 있음)
• 브라우저를 실행하거나 디버그 포트를 노출할 수 없을 때(이 스킬은 브라우저 자동화에 의존함)
• UI 상호작용 없이 완전히 프로그래밍 방식의 접근만 필요할 때

다만 많은 운영 워크플로에서는 agent-browser를 통해 기존 Slack 웹 UI를 활용하는 방식이 가장 빠르게 시작할 수 있는 방법입니다.

---

How to Use

Installation and setup

1. Add the slack skill

npx를 사용해 에이전트 스킬 환경에 slack 스킬을 추가합니다:

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

위 명령은 vercel-labs/agent-browser 리포지토리에서 slack 스킬 정의와 지원 파일들(SKILL.md, references, templates 등)을 가져옵니다.

2. Prepare a Slack browser session

slack 스킬은 agent-browser가 제어할 수 있는 브라우저에서 Slack이 열려 있거나 열 수 있다는 전제를 가집니다.

일반적인 설정 패턴:

# 옵션 A: 이미 Slack이 열려 있는 브라우저 세션에 연결
agent-browser connect 9222

# 옵션 B: 아직 Slack이 실행 중이 아니라면 바로 열기
agent-browser open https://app.slack.com

위 예시의 포트(9222)는 원격 디버깅 옵션으로 브라우저를 어떻게 실행했는지에 따라 달라집니다. 실제 환경에 맞게 조정하세요.

3. Confirm agent-browser access

연결 또는 실행이 완료되면, 스냅샷을 캡처해 Slack UI에 접근 가능한지 확인합니다:

agent-browser snapshot -i

이 스냅샷에는 이후 명령에서 클릭·읽기·자동화에 사용할 수 있는 인터랙티브 요소들이 @e1, @e2 같은 ref 형태로 표시됩니다.

---

Core workflow pattern

1. Connect or open Slack

모든 세션은 Slack 웹 앱에 연결하는 것으로 시작합니다:

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

2. Discover elements with a snapshot

스냅샷을 사용해 현재 Slack 화면에 무엇이 보여지는지 확인합니다:

agent-browser snapshot -i

출력에서 Activity 탭의 @e14, DMs의 @e13, "More unreads" 버튼에 해당하는 ref 등 다양한 요소를 확인할 수 있습니다. 이러한 ref를 사용하면 네비게이션을 안정적으로 스크립팅할 수 있습니다.

3. Navigate to the relevant view

필요에 따라 탭을 클릭하고, 사이드바를 확장하고, 섹션을 여는 식으로 이동합니다:

# 예: Activity 탭 열기
agent-browser click @e14
agent-browser wait 1000

네비게이션 후에는 스냅샷을 다시 실행해 새로 노출된 요소와 텍스트를 파악합니다.

4. Extract information or take actions

원하는 뷰에 도달하면 다음과 같은 작업을 수행할 수 있습니다:

• 스냅샷에서 메시지 텍스트, 채널 이름, 카운트 값 읽기
• 개별 채널이나 DM으로 클릭 이동
• 스크롤하며 이후 요약에 사용할 스크린샷 캡처

읽지 않은 항목을 확인하는 기본 패턴 예시는 다음과 같습니다:

agent-browser connect 9222
agent-browser snapshot -i
# 스냅샷 출력에서 "More unreads"를 찾습니다.
agent-browser click @e21   # "More unreads" 버튼에 대한 예시 ref
agent-browser screenshot slack-unreads.png

5. Capture evidence

Slack 관련 감사, 인시던트 리뷰, 데일리 스탠드업 요약 등에서는 스크린샷과 구조화된 노트가 필요한 경우가 많습니다.

다음 명령으로:

agent-browser screenshot activity.png

스크린샷을 캡처한 뒤, 아래에서 설명하는 리포트 템플릿을 참고해 원시 결과를 표준화된 리포트로 정리합니다.

---

Common Slack automation tasks

리포지토리에는 자주 사용하는 워크플로 패턴을 단계별로 정리한 references/slack-tasks.md가 포함되어 있습니다. 주요 작업 예시는 다음과 같습니다:

Check all unread messages across Slack

아직 읽지 않은 항목을 전체적으로 파악하고 싶을 때 사용합니다.

고수준 단계(자세한 내용은 references/slack-tasks.md 참고):

1. Slack에 연결:

   agent-browser connect 9222
   

2. Activity 탭을 열고 Slack이 읽지 않은 항목이 없다고 표시하는지 확인합니다.
3. DMs 탭으로 전환해 읽지 않은 배지가 있는 대화를 식별합니다.
4. 채널 사이드바에서 "More unreads"를 확장해 읽지 않은 채널을 나열합니다.
5. 각 뷰의 스크린샷을 캡처해 하나의 요약으로 묶습니다.

이 패턴은 정기적으로 실행되는 "check my Slack" 자동화나, 진행 전에 사용자가 최신 상태인지 확인해야 하는 에이전트에 특히 유용합니다.

Find all channels in a workspace

접근 가능한 채널 목록(인벤토리)이 필요할 때 사용합니다:

1. 연결 및 스냅샷 실행:

   agent-browser connect 9222
   agent-browser snapshot -i
   

2. 사이드바에서 "Channels" 섹션을 찾습니다.
3. 해당 섹션을 확장하고 예를 들어 all-channels.png 같은 이름으로 스크린샷을 캡처합니다.
4. 스냅샷 출력에서 채널 이름을 파싱합니다.

이 패턴은 채널 구조를 매핑하거나, 활동 유형을 분류하거나, 워크스페이스 개요를 생성하는 자동화의 기반이 됩니다.

---

Using templates and references

Reference playbooks

references/ 폴더에는 Slack 자동화를 위한 준비된 안내서가 들어 있습니다:

• references/slack-tasks.md – 읽지 않은 항목 확인, 채널 목록 조회 등 일반적인 워크플로에 대한 패턴 정리

이 파일을 에이전트나 스크립트용 플레이북처럼 활용해, 여기에 정의된 순서를 블록 단위로 재사용할 수 있습니다.

Reporting templates

templates/ 폴더에는 구조화된 리포트 템플릿이 포함되어 있습니다:

• templates/slack-report-template.md – Slack 분석을 위한 Markdown 리포트 구조

이 템플릿에는 다음과 같은 섹션이 포함됩니다:

• Activity, DMs, 채널별 읽지 않은 개수
• 읽지 않은 채널 및 DM 목록
• 채널 스냅샷 통계
• 가장 활동적인 채널과 주요 대화

이 템플릿을 사용해 자동화 결과를 이해관계자에게 전달하기 좋은 표준 Slack 리포트 형식으로 정리할 수 있습니다.

---

Files to review first

slack 스킬을 이해하고 확장하려면 리포지토리에서 다음 파일들을 먼저 살펴보세요:

• SKILL.md – slack 스킬의 기본 정의, 설명, 사용 가능한 도구 목록
• references/slack-tasks.md – 상세 작업 흐름과 자동화 패턴
• templates/slack-report-template.md – 사람이 읽기 좋은 Slack 리포트 구조

이 파일들을 보면 전체 리포지토리를 모두 살펴보지 않고도 의도한 사용 패턴을 빠르게 파악할 수 있습니다.

---

FAQ

What is the slack skill in agent-browser?

slack 스킬은 agent-browser가 Slack 웹 UI를 통해 워크스페이스와 상호작용하는 방법을 정의한 재사용 가능한 자동화 프로파일입니다. 읽지 않은 항목 점검, 채널·DM 네비게이션, 검색, 데이터 추출 같은 작업을 Slack API 대신 브라우저 자동화로 수행하는 데 초점을 맞춥니다.

How do I install the slack skill?

vercel-labs/agent-browser 리포지토리에서 npx를 통해 설치합니다:

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

설치 후에는 agent-browser를 실행할 수 있고, Slack이 열려 있거나 열 수 있는 브라우저에 연결 가능한지 확인하세요.

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

필요하지 않습니다. slack 스킬은 브라우저에서 동작하는 Slack web application과 상호작용합니다. 해당 브라우저에서 Slack에 로그인되어 있고 agent-browser가 그 브라우저를 제어할 수 있다면, 사용자의 기존 접근 권한과 퍼미션을 그대로 활용해 작업을 수행합니다.

Can this skill read all messages in my workspace?

이 스킬은 로그인한 Slack 계정이 웹 인터페이스를 통해 볼 수 있는 범위만 접근할 수 있습니다. 권한을 우회하지 않으며, 워크스페이스의 모든 메시지를 장기 이력 수준으로 내보내는 용도보다는, 읽지 않은 항목, 채널 목록, 최근 활동 등 운영 점검에 더 적합합니다.

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

@e14 같은 ref는 각 agent-browser snapshot 실행 시점에 생성되며, 세션마다 달라질 수 있고 Slack UI 업데이트에 따라서도 바뀔 수 있습니다. references/slack-tasks.md에서는 스냅샷 출력에서 "Activity", "DMs", "More unreads" 같은 레이블을 먼저 찾고, 그에 대응하는 ref 값을 동적으로 사용해 하드코딩을 피하는 패턴을 설명합니다.

Is the slack skill suitable for headless or server environments?

agent-browser가 연결할 수 있는 원격 디버깅 모드의 브라우저를 실행할 수 있는 환경이라면 서버나 headless 환경에서도 사용할 수 있습니다. 반대로 브라우저를 전혀 실행하거나 접근할 수 없는 환경이라면, 이 브라우저 기반 스킬은 적합하지 않으며 API 기반 통합이 더 나은 선택일 수 있습니다.

What categories of automation does this skill support?

slack 스킬은 기본적으로 workflow-automation 도구이면서, 동시에 browser-automation 도구입니다. 다음과 같은 CLI 또는 에이전트 기반 워크플로에 특히 적합합니다:

• 다른 job 실행 전에 Slack 상태를 점검
• 인시던트 대응이나 지원 프로세스의 일부로 Slack에서 정보 수집
• 템플릿을 활용해 표준화된 Slack 활동 리포트 생성

Where can I learn the detailed task flows?

스킬의 Files 뷰를 열고 다음 파일들을 확인하세요:

• SKILL.md – 상위 레벨 정의와 빠른 시작 예제
• references/slack-tasks.md – 개별 작업 단위의 단계별 안내
• templates/slack-report-template.md – 리포트 구조 정의

이 문서들을 함께 보면, slack 스킬을 자신의 워크플로와 제약 조건에 어떻게 맞춰 활용할지 결정할 수 있을 만큼 충분한 세부 정보를 얻을 수 있습니다.