# Slack Notify

> Use when the user asks to send Slack notifications, create task threads, post progress updates, read thread replies, or wants session activity reported to Slack.

- Skill: `amitkot/slack-notify` (Agent Skill)
- Install (CLI): `npx skillmds@latest add amitkot/slack-notify`
- Raw SKILL.md: https://api.skillmd.com/api/skills/amitkot/slack-notify/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: amitkot (https://skillmd.com/u/amitkot)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/amitkot/slack-notify

---


# Slack Notifications

Post updates to Slack with threading support. Create a thread per task, post updates as replies, read replies from the user.

## Quick Reference

```bash
SCRIPT="${CLAUDE_PLUGIN_ROOT}/scripts/slack.py"

# Create a new thread
python3 "$SCRIPT" thread "Starting: feature X implementation"

# Post update to current thread
python3 "$SCRIPT" update "Completed step 1: database migration"

# Read recent replies from the thread
python3 "$SCRIPT" read        # last 10 messages
python3 "$SCRIPT" read 20     # last 20 messages

# Check current thread
python3 "$SCRIPT" status
```

## Workflow

1. **Task start**: `thread` with a descriptive subject
2. **Milestones**: `update` with progress (completed steps, decisions, blockers)
3. **Check for feedback**: `read` to see if the user replied in the thread
4. **Task end**: `update` with a summary

## Setup

Create `~/.claude/slack-notify.json`:
```json
{"bot_token": "xoxb-...", "channel": "C..."}
```

Get these from your Slack app at api.slack.com/apps → OAuth & Permissions (bot token) and channel details (channel ID).

Required bot scopes: `chat:write`. To read thread replies, add `groups:history` (private channels) or `channels:history` (public channels).

## Thread State

Active thread stored in `~/.claude/.slack-thread-state.json`. Creating a new thread replaces the previous one.