# Slack

> Slack API integration — send/read messages, react to messages, pin items, and fetch member info. Use when: user wants to send a Slack message, check Slack channels, react to a message, or manage pins. NOT for: Discord (use Discord channel), email (use email skill), or real-time Slack event streaming.

- **Type:** Skill
- **Install:** `agentstack add skill-ericwang915-pythonclaw-slack`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ericwang915](https://agentstack.voostack.com/s/ericwang915)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ericwang915](https://github.com/ericwang915)
- **Source:** https://github.com/ericwang915/PythonClaw/tree/main/pythonclaw/templates/skills/communication/slack
- **Website:** https://github.com/ericwang915/PythonClaw

## Install

```sh
agentstack add skill-ericwang915-pythonclaw-slack
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Slack

Interact with Slack workspaces via the Slack Web API.

## When to Use

✅ **USE this skill when:**

- "Send a message to #general"
- "React to that Slack message with a thumbs up"
- "Read recent messages from #engineering"
- "Pin this message in the channel"
- "Who is user U12345?"
- "List pinned items in #announcements"

## When NOT to Use

❌ **DON'T use this skill when:**

- Discord messaging → use the Discord channel directly
- Email → use `email` skill
- Real-time Slack event listening → requires a Slack app with event subscriptions
- File uploads → use Slack's files.upload API directly

## Setup

1. Create a Slack app at https://api.slack.com/apps
2. Add Bot Token Scopes: `chat:write`, `channels:read`, `channels:history`, `reactions:write`, `reactions:read`, `pins:write`, `pins:read`, `users:read`
3. Install the app to your workspace
4. Copy the Bot User OAuth Token (starts with `xoxb-`)
5. Configure in `pythonclaw.json`:

```json
"skills": {
  "slack": {
    "token": "xoxb-your-bot-token"
  }
}
```

## Commands

### Send a message

```bash
python {skill_path}/slack_api.py send --channel "#general" --text "Hello from PythonClaw"
```

### Read recent messages

```bash
python {skill_path}/slack_api.py read --channel "#general" --limit 10
```

### React to a message

```bash
python {skill_path}/slack_api.py react --channel "C123" --timestamp "1712023032.1234" --emoji "white_check_mark"
```

### Pin a message

```bash
python {skill_path}/slack_api.py pin --channel "C123" --timestamp "1712023032.1234"
```

### Get member info

```bash
python {skill_path}/slack_api.py user --user-id "U123"
```

### List channels

```bash
python {skill_path}/slack_api.py channels
```

## Notes

- Channel names can be used with `#` prefix or as channel IDs (C...)
- Message timestamps serve as unique message IDs in Slack
- Rate limits: ~1 request/second for most methods
- Bot must be invited to channels to read/post messages

## Resources

| File | Description |
|------|-------------|
| `slack_api.py` | Slack Web API client |

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ericwang915](https://github.com/ericwang915)
- **Source:** [ericwang915/PythonClaw](https://github.com/ericwang915/PythonClaw)
- **License:** MIT
- **Homepage:** https://github.com/ericwang915/PythonClaw

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-ericwang915-pythonclaw-slack
- Seller: https://agentstack.voostack.com/s/ericwang915
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.