Skip to main content
skill CX Codex

slack · acedatacloud — Claude Code skill: what it does, how to install

Searches public Slack channels and sends bot messages after explicit user confirmation.

Apache-2.0 215 installs ★ 17 updated 2026-10-25

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add AceDataCloud/Skills --skill slack -a claude-code
Open on GitHub

What slack does

This skill queries the Slack Web API using curl and jq. It relies on two environment variables: $SLACK_TOKEN for reading conversations where the bot is a member and posting updates, and $SLACK_USER_TOKEN for searching public channels through the assistant.search.context endpoint.

The bot cannot join channels on its own. Without adding the bot manually to a private conversation first, any API read attempt will fail. Outbound messages require explicit confirmation through action approval prompts, preventing accidental posts by defaulting to drafts.

What it helps with

  • search public workspace channels for incidents and key terms
  • inspect thread context and message history by timestamp
  • post approved notifications to channels using the bot identity
  • look up workspace members by email address

Example prompts for the agent

  • Search public Slack channels for recent messages mentioning deployment issue
  • Read the latest 15 messages from thread 1777656720.123456 in channel C0123456789
  • Draft and send a release notification to channel C0123456789

How to install slack

1Skills CLI (Vercel)

npx skills add AceDataCloud/Skills --skill slack -a claude-code

2Manually: put the files in place

~/.claude/skills/slack/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/slack/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about slack

How to install slack in Claude Code?

Run npx skills add AceDataCloud/Skills --skill slack -a claude-code. The configuration is stored at ~/.claude/skills/slack/SKILL.md.

What does the slack skill do?

It searches public workspace messages, reads conversations where the bot is present, and sends confirmed channel replies.

Why does the bot fail to access private conversations?

The skill cannot automatically join conversations via the API. You must invite the bot to the private channel manually before querying history.

Source text

SKILL.md · Apache-2.0
---
name: slack
description: Search Slack public channels, read joined conversations, and send user-confirmed bot messages.
when_to_use: |
  Use when the user wants to search public Slack channels, read or summarize
  conversations the app has joined, or send a message as the connected bot.
connections: [slack]
allowed_tools: [Bash]
license: Apache-2.0
metadata:
  author: acedatacloud
  version: "1.4"
---

Use the [Slack Web API](https://api.slack.com/methods) with the connected
bot token in `$SLACK_TOKEN` for joined-channel reads and confirmed sends.
Use the separate user token in `$SLACK_USER_TOKEN` only for public-channel
search. Send either token only to `https://slack.com/api/` over HTTPS. Check
the JSON `ok` field and HTTP status for every response; report Slack's
error value when a call fails. Respect `Retry-After` on HTTP 429.

Messages are sent as the AceDataCloud bot, not as the user's Slack account.
The app cannot upload files or join channels. Bot channel and conversation
history is available only where the app has been added. Public search covers
public channels in the authorized user's workspace, including channels the
bot has not joined; it does not cover private channels or direct messages.
The bot token cannot use Slack's legacy `search.messages` method and cannot
use Real-time Search without a Slack event `action_token`. Never use the user
token to post a message.

## Search public-channel messages

Use Slack's Real-time Search API for a user-initiated public search. If
`$SLACK_USER_TOKEN` is absent, explain that the Slack connection needs
re-authorization for public search at
`https://studio.acedata.cloud/console/connectors`; do not silently substitute
a recent-history scan. Keep `channel_types` explicitly limited to
`public_channel` and `content_types` to `messages`. Request at most 20 results
per page, follow `next_cursor` only as needed, and give the user message
permalinks as sources. Do not persist Slack search results outside the
current task.

```sh
QUERY="deployment issue"
curl -sS -X POST https://slack.com/api/assistant.search.context \
  -H "Authorization: Bearer $SLACK_USER_TOKEN" \
  -H "Content-Type: application/json; charset=utf-8" \
  -d "$(jq -nc --arg q "$QUERY" \
    '{query:$q, channel_types:["public_channel"], content_types:["messages"], limit:20}')" \
  | jq '{ok, error, next_cursor, messages: [.results.messages[]? | {content, author_name, channel_name, message_ts, permalink}]}'
```

If Slack returns an error, report that error rather than presenting an empty
result as a successful search. Search results are limited to the authorized
user's public-channel access and Slack's search ranking and retention rules.

## Verify the connected workspace

```sh
curl -sS -H "Authorization: Bearer $SLACK_TOKEN" \
  https://slack.com/api/auth.test
```

Use the returned team and bot user to check that the connection targets the
workspace the user intended.

## List channels visible to the app

```sh
curl -sS -G -H "Authorization: Bearer $SLACK_TOKEN" \
  https://slack.com/api/conversations.list \
  --data-urlencode "types=public_channel,private_channel" \
  --data-urlencode "limit=200"
```

Follow `response_metadata.next_cursor` to paginate. Resolve channel names
to IDs from this response rather than inventing IDs.

## Read channel history or a thread

```sh
curl -sS -G -H "Authorization: Bearer $SLACK_TOKEN" \
  https://slack.com/api/conversations.history \
  --data-urlencode "channel=C0123456789" \
  --data-urlencode "limit=15"

curl -sS -G -H "Authorization: Bearer $SLACK_TOKEN" \
  https://slack.com/api/conversations.replies \
  --data-urlencode "channel=C0123456789" \
  --data-urlencode "ts=1777656720.123456"
```

Read a private channel or direct message only if the app is a member. If
Slack returns `not_in_channel` or `channel_not_found`, ask the user to add
the app to that conversation. Do not try to join it automatically.

## Find a keyword in one joined private channel or direct message

For a private channel or direct message that the bot has joined, fetch only
that conversation's recent history and filter locally. This is a bounded
recent-history scan, not Slack's public search. State the time window and
whether older messages remain unread. On new installs of
commercial apps outside the Slack Marketplace, Slack may limit
`conversations.history` to one call per minute with at most 15 messages;
respect `Retry-After` and do not fan out across channels.

```sh
KEYWORD="deploy"
curl -sS -G -H "Authorization: Bearer $SLACK_TOKEN" \
  https://slack.com/api/conversations.history \
  --data-urlencode "channel=C0123456789" \
  --data-urlencode "limit=15" \
  | jq --arg q "$KEYWORD" '{ok, error, has_more, matches: [.messages[]? | select((.text // "") | contains($q)) | {ts, user, text}]}'
```

If Slack returns an error, report it rather than claiming the search
succeeded. An empty match list is only a result for the messages fetched,
not proof that the keyword is absent from the channel's full history.

## Resolve a member

```sh
curl -sS -G -H "Authorization: Bearer $SLACK_TOKEN" \
  https://slack.com/api/users.lookupByEmail \
  --data-urlencode "[email protected]"
```

Use member details only to identify people in retrieved content. Do not send
unsolicited direct messages or enumerate members for outreach.

## Send a message or thread reply

Before each send, resolve the exact workspace, channel or existing
conversation, and final message text. Call `request_action_confirmation`
with `kind: "generic"` and show those three values. Send only if the user
confirms. If the confirmation tool is unavailable, return a draft. If this
is an unattended run, send only when the saved task already authorizes that
exact destination and content; otherwise return a draft.

The bot must already be a member of the target channel or conversation.
If Slack returns `not_in_channel` or `channel_not_found`, ask the user
to add the app there. Do not call `conversations.join`. Do not retry a
`chat.postMessage` request whose outcome is unknown; first check the
channel history to avoid duplicates.

```sh
curl -sS -X POST https://slack.com/api/chat.postMessage \
  -H "Authorization: Bearer $SLACK_TOKEN" \
  -H "Content-Type: application/json; charset=utf-8" \
  -d "$(jq -nc --arg ch "C0123456789" --arg text "Confirmed message" \
    '{channel:$ch, text:$text}')"
```

For a reply in an existing thread, include its exact `thread_ts` in the
payload. Check `ok`, `channel`, and `ts` in the response and report the
sent message link or channel and timestamp.

If `auth.test` returns `not_authed` or `invalid_auth`, ask the user to
reconnect Slack at `https://studio.acedata.cloud/console/connectors`.

© acedatacloud · Apache-2.0 · AceDataCloud/Skills

Similar skills

All skills for Notes, tasks and projects →

slack by other authors comes first.

slack openclaw This skill connects Slack workflows to OpenClaw through the message tool. Use it when an agent needs to read or send Slack messages. CX Codex +1 3,100installs slack vercel-labs Runs a stateful local Slack Web API emulator for testing integrations, bots, OAuth flows, webhooks, and message handling without the real Slack service. CX Codex +1 212installs slack membrane Skill for Claude Code and Codex. Uses Membrane CLI to give the agent access to Slack channels, messages, files, and reminders. CX Codex +1 569installs slack-search official anthropics Adds four Slack search tools to the agent. Agent searches public channels, all channels including private, channel names and users. CX Codex +1 3,300installs slack-automation davepoon slack-automation automates Slack workspace operations, messaging, threads, reactions, and search through Rube MCP and Composio. CX Codex +1 128installs c-slack daxaur c-slack lets the agent talk to Slack through the CLI: channel and DM messages, file uploads, thread replies. CX Codex +1 ★ 179repo stars slack-messaging official anthropics The slack-messaging skill helps agents write Slack messages with mrkdwn, clear structure, and channel-aware etiquette. Use it for drafts, replies, and announcements. CX Codex +1 4,100installs connector-slack caffeinelabs connector-slack — a skill that gets your agent posting messages to a Slack channel from a Caffeine canister through the slack-client package. The recipe is marked experimental. CX Codex +1 18,400installs slack-workflows claude-office-skills slack-workflows builds Slack automations for daily standups, expense approvals, incident alerts, and onboarding flows using the slack-mcp server tools. CX Codex +1 5,100installs

From the same set67

The whole set →

Project sponsors

Companies that keep this analytics open