Agent skill
slack-api
Slack bot development and workspace automation using Web API, Events API, Socket Mode, and Block Kit for building interactive messaging applications
Install this agent skill to your Project
npx add-skill https://github.com/vamseeachanta/workspace-hub/tree/main/.claude/skills/business/communication/slack-api
SKILL.md
Slack Api
When to Use This Skill
USE when:
- Building notification systems for CI/CD pipelines
- Creating interactive bots for team workflows
- Automating incident response and alerting
- Building approval workflows with interactive messages
- Integrating external services with Slack channels
- Creating slash commands for common operations
- Building internal tools with modal dialogs
- Implementing scheduled message automation
DON'T USE when:
- Microsoft Teams is the primary platform (use teams-api)
- Simple one-way notifications only (use incoming webhooks directly)
- Need email-based workflows (different domain)
- Slack Enterprise Grid with complex org requirements
- Real-time gaming or high-frequency updates (consider WebSockets)
Prerequisites
Slack App Setup
# 1. Create a Slack App at https://api.slack.com/apps
# 2. Choose "From scratch" and select your workspace
# Required Bot Token Scopes (OAuth & Permissions):
# - chat:write - Post messages
# - chat:write.public - Post to channels without joining
# - channels:read - List public channels
# - channels:history - Read channel messages
# - groups:read - List private channels
*See sub-skills for full details.*
### Python Environment Setup
```bash
# Create virtual environment
python -m venv slack-bot-env
source slack-bot-env/bin/activate # Linux/macOS
# slack-bot-env\Scripts\activate # Windows
# Install Slack Bolt SDK
pip install slack-bolt slack-sdk
# Install additional dependencies
*See sub-skills for full details.*
### Local Development with ngrok
```bash
# Install ngrok
brew install ngrok # macOS
# Or download from https://ngrok.com/download
# Authenticate ngrok
ngrok config add-authtoken YOUR_AUTH_TOKEN
# Start tunnel for local development
ngrok http 3000
*See sub-skills for full details.*
## Version History
| Version | Date | Changes |
|---------|------|---------|
| 1.0.0 | 2026-01-17 | Initial release with comprehensive Slack API patterns |
## Resources
- [Slack API Documentation](https://api.slack.com/)
- [Bolt for Python](https://slack.dev/bolt-python/)
- [Block Kit Builder](https://app.slack.com/block-kit-builder/)
- [Slack App Manifest](https://api.slack.com/reference/manifests)
- [Socket Mode](https://api.slack.com/apis/connections/socket)
- [Events API](https://api.slack.com/events-api)
---
*This skill provides production-ready patterns for Slack bot development, enabling powerful team automation and interactive workflows.*
## Sub-Skills
- [1. Basic Slack Bot with Bolt](1-basic-slack-bot-with-bolt/SKILL.md)
- [2. Block Kit Messages](2-block-kit-messages/SKILL.md)
- [3. Interactive Components and Actions](3-interactive-components-and-actions/SKILL.md)
- [4. Modals and Views](4-modals-and-views/SKILL.md)
- [5. Slash Commands](5-slash-commands/SKILL.md)
- [6. Webhooks and Incoming Messages](6-webhooks-and-incoming-messages/SKILL.md)
- [GitHub Actions Integration (+1)](github-actions-integration/SKILL.md)
- [1. Rate Limiting (+3)](1-rate-limiting/SKILL.md)
- [Common Issues (+1)](common-issues/SKILL.md)
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
vamseeachanta/workspace-hub
gsd-complete-milestone
Archive completed milestone and prepare for next version
vamseeachanta/workspace-hub
gsd-reapply-patches
Reapply local modifications after a GSD update
vamseeachanta/workspace-hub
gsd-verify-work
Validate built features through conversational UAT
vamseeachanta/workspace-hub
gsd-thread
Manage persistent context threads for cross-session work
vamseeachanta/workspace-hub
clinical-trial-protocol
Generate clinical trial protocols for medical devices or drugs through a modular, waypoint-based architecture with research-only and full protocol modes.
vamseeachanta/workspace-hub
single-cell-rna-qc
Performs quality control on single-cell RNA-seq data (.h5ad or .h5 files) using scverse best practices with MAD-based filtering and comprehensive visualizations.
Didn't find tool you were looking for?