Skip to main content
slack-notifications Slack messaging, channels, and notifications - send messages, manage channels, interact with users, upload files, and add reactions. Use for team communication, incident notifications, and workflow alerts.
Jump to install Skills Marketplace Discover and explore AI skills built by the community.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Show prompt details A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/oimiragieo/agent-studio --skill slack-notificationsThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Download Zip Downloading... Related occupations SOC
Based on SOC occupation classification
name slack-notifications description Slack messaging, channels, and notifications - send messages, manage channels, interact with users, upload files, and add reactions. Use for team communication, incident notifications, and workflow alerts. version 1.0.0 model sonnet invoked_by both user_invocable true tools ["Bash","Read","WebFetch"] best_practices ["Never expose bot token in logs","Use least-privilege scopes","Validate channel permissions before posting"] error_handling graceful streaming supported verified false lastVerifiedAt "2026-02-19T05:29:09.098Z" source builtin trust_score 100 provenance_sha c09a69081f8a7d83
Mode: Cognitive/Prompt-Driven — No standalone utility script; use via agent context.
Slack Notifications Skill
Overview
This skill provides Slack API operations with progressive disclosure for optimal context usage.
Context Savings : ~90% reduction
MCP Mode : ~15,000 tokens always loaded (30+ tools)Skill Mode : ~500 tokens metadata + on-demand loading
Requirements
SLACK_BOT_TOKEN environment variable (required)SLACK_SIGNING_SECRET environment variable (optional, for event verification)SLACK_APP_TOKEN environment variable (optional, for Socket Mode)
Setting up Slack Bot Token
Create a Slack App at https://api.slack.com/apps
Navigate to "OAuth & Permissions"
Add required bot token scopes:
chat:write - Send messageschannels:read - List channelschannels:history - Read channel historyusers:read - List usersfiles:write - Upload filesreactions:write - Add reactions
Install app to workspace
Copy "Bot User OAuth Token" to SLACK_BOT_TOKEN environment variable
Tools
The skill provides 14 tools across 5 categories:
Category Tools Confirmation Required Messaging post-message, post-thread, update-message, delete-message Yes (all) Channels list-channels, get-channel, channel-history No Users list-users, get-user, user-presence No Files upload-file, list-files Yes (upload only) Reactions add-reaction, get-reactions No
Quick Reference
curl -X POST https://slack.com/api/chat.postMessage \
-H "Authorization: Bearer $SLACK_BOT_TOKEN "
"Content-Type: application/json"
'{"channel": "C1234567890", "text": "Hello from Claude!"}'
"https://slack.com/api/conversations.list"
"Authorization: Bearer $SLACK_BOT_TOKEN "
"Authorization: Bearer $SLACK_BOT_TOKEN "
"channels=C1234567890"
"file=@report.pdf"
"title=Weekly Report"
Tool Details
Messaging Tools (Confirmation Required)
post-message Send a message to a Slack channel.
channel (required): Channel ID or name (e.g., "C1234567890" or "#general")text (required): Message text (supports Slack markdown)thread_ts (optional): Parent message timestamp for threadingblocks (optional): Rich message blocks (JSON array) curl -X POST https://slack.com/api/chat.postMessage \
-H "Authorization: Bearer $SLACK_BOT_TOKEN " \
-H "Content-Type: application/json" \
-d '{
"channel": "C1234567890",
"text": "Deployment successful!",
"blocks": [
{
"type": "section",
"text": {
"type": "mrkdwn",
"text": "*Deployment Status*\n:white_check_mark: Production deployed successfully"
}
}
]
}'
post-thread Reply to a message in a thread.
channel (required): Channel IDthread_ts (required): Parent message timestamptext (required): Reply text curl -X POST https://slack.com/api/chat.postMessage \
-H "Authorization: Bearer $SLACK_BOT_TOKEN " \
-H "Content-Type: application/json" \
-d '{
"channel": "C1234567890",
"thread_ts": "1234567890.123456",
"text": "Thread reply here"
}'
update-message Update an existing message.
channel (required): Channel IDts (required): Message timestamptext (required): New message text curl -X POST https://slack.com/api/chat.update \
-H "Authorization: Bearer $SLACK_BOT_TOKEN " \
-H "Content-Type: application/json" \
-d '{
"channel": "C1234567890",
"ts": "1234567890.123456",
"text": "Updated message"
}'
delete-message
channel (required): Channel IDts (required): Message timestamp curl -X POST https://slack.com/api/chat.delete \
-H "Authorization: Bearer $SLACK_BOT_TOKEN " \
-H "Content-Type: application/json" \
-d '{
"channel": "C1234567890",
"ts": "1234567890.123456"
}'
Channel Tools
list-channels List all channels in workspace.
types (optional): Comma-separated channel types (default: "public_channel")
Options: "public_channel", "private_channel", "mpim", "im"
limit (optional): Max channels to return (default: 100) curl -X GET "https://slack.com/api/conversations.list?types=public_channel,private_channel" \
-H "Authorization: Bearer $SLACK_BOT_TOKEN "
get-channel
channel (required): Channel ID curl -X GET "https://slack.com/api/conversations.info?channel=C1234567890" \
-H "Authorization: Bearer $SLACK_BOT_TOKEN "
channel-history Get channel message history.
channel (required): Channel IDlimit (optional): Max messages to return (default: 100)oldest (optional): Start of time range (Unix timestamp)latest (optional): End of time range (Unix timestamp) curl -X GET "https://slack.com/api/conversations.history?channel=C1234567890&limit=50" \
-H "Authorization: Bearer $SLACK_BOT_TOKEN "
Security Note : Channel history may contain sensitive information. Use with caution.
User Tools
list-users List all users in workspace.
limit (optional): Max users to return (default: 100) curl -X GET "https://slack.com/api/users.list" \
-H "Authorization: Bearer $SLACK_BOT_TOKEN "
get-user Get user profile information.
curl -X GET "https://slack.com/api/users.info?user=U1234567890" \
-H "Authorization: Bearer $SLACK_BOT_TOKEN "
user-presence curl -X GET "https://slack.com/api/users.getPresence?user=U1234567890" \
-H "Authorization: Bearer $SLACK_BOT_TOKEN "
File Tools
upload-file (Confirmation Required) Upload a file to Slack channel.
channels (required): Comma-separated channel IDsfile (required): File path to uploadtitle (optional): File titleinitial_comment (optional): Message text curl -X POST https://slack.com/api/files.upload \
-H "Authorization: Bearer $SLACK_BOT_TOKEN " \
-F "channels=C1234567890" \
-F "file=@C:\reports\weekly.pdf" \
-F "title=Weekly Report" \
-F "initial_comment=Here is this week's report"
list-files
channel (optional): Channel ID to filter byuser (optional): User ID to filter bycount (optional): Max files to return (default: 100) curl -X GET "https://slack.com/api/files.list?channel=C1234567890" \
-H "Authorization: Bearer $SLACK_BOT_TOKEN "
Reaction Tools
add-reaction Add emoji reaction to a message.
channel (required): Channel IDtimestamp (required): Message timestampname (required): Emoji name (without colons, e.g., "thumbsup") curl -X POST https://slack.com/api/reactions.add \
-H "Authorization: Bearer $SLACK_BOT_TOKEN " \
-H "Content-Type: application/json" \
-d '{
"channel": "C1234567890",
"timestamp": "1234567890.123456",
"name": "thumbsup"
}'
get-reactions Get reactions on a message.
channel (required): Channel IDtimestamp (required): Message timestamp curl -X GET "https://slack.com/api/reactions.get?channel=C1234567890×tamp=1234567890.123456" \
-H "Authorization: Bearer $SLACK_BOT_TOKEN "
Agent Integration
Primary Agents
devops : Infrastructure alerts, deployment notifications, monitoringincident-responder : Incident alerts, status updates, escalations
Secondary Agents
pm : Sprint notifications, milestone updates, team announcementsdeveloper : Build notifications, PR alerts, test resultsqa : Test failure alerts, quality reportssecurity-architect : Security alerts, vulnerability notifications
Common Use Cases
Deployment Notifications
curl -X POST https://slack.com/api/chat.postMessage \
-H "Authorization: Bearer $SLACK_BOT_TOKEN " \
-H "Content-Type: application/json" \
-d '{
"channel": "#deployments",
"text": ":rocket: Production deployment completed",
"blocks": [
{
"type": "section",
"text": {
"type": "mrkdwn",
"text": "*Production Deployment*\n:white_check_mark: v1.2.3 deployed successfully\n*Duration:* 5m 23s"
}
}
]
}'
Incident Alerts
curl -X POST https://slack.com/api/chat.postMessage \
-H "Authorization: Bearer $SLACK_BOT_TOKEN " \
-H "Content-Type: application/json" \
-d '{
"channel": "#incidents",
"text": "<!channel> :rotating_light: High severity incident detected",
"blocks": [
{
"type": "section",
"text": {
"type": "mrkdwn",
"text": "*Incident INC-1234*\n:rotating_light: *Severity:* P1\n*Service:* API Gateway\n*Status:* 503 errors increasing"
}
}
]
}'
Test Results
curl -X POST https://slack.com/api/chat.postMessage \
-H "Authorization: Bearer $SLACK_BOT_TOKEN " \
-H "Content-Type: application/json" \
-d '{
"channel": "#qa",
"text": "Test suite completed",
"blocks": [
{
"type": "section",
"text": {
"type": "mrkdwn",
"text": "*Test Results*\n:white_check_mark: 245 passed\n:x: 3 failed\n:warning: 2 skipped"
}
}
]
}'
Security Considerations
Token Security
NEVER expose bot token in logs or error messagesStore token in environment variable, not in code
Use least-privilege scopes for bot token
Rotate tokens periodically
Message Security
All message operations require confirmation
Channel history may contain sensitive information (PII, credentials, etc.)
Validate channel permissions before posting
Use private channels for sensitive communications
Data Privacy
Comply with workspace data retention policies
Avoid posting PII or credentials in messages
Use Slack's data export features for compliance
Respect user privacy and online status
Error Handling
Common Errors Error Cause Solution not_authedMissing or invalid token Check SLACK_BOT_TOKEN is set correctly channel_not_foundInvalid channel ID Verify channel ID with list-channels missing_scopeBot lacks required permission Add scope in Slack App settings rate_limitedToo many requests Implement exponential backoff message_not_foundInvalid timestamp Check message timestamp is correct
Retry Strategy For rate limiting errors, implement exponential backoff:
Wait 1 second, retry
Wait 2 seconds, retry
Wait 4 seconds, retry
Wait 8 seconds, retry
Give up after 5 attempts
Rate Limits
Tier 1 : 1 request per secondTier 2 : 20 requests per minuteTier 3 : 50 requests per minuteTier 4 : 100 requests per minute
chat.postMessage: Tier 3 (50/min)conversations.list: Tier 2 (20/min)users.list: Tier 2 (20/min)files.upload: Tier 4 (100/min)
Related
Memory Protocol (MANDATORY) Before starting:
Read .claude/context/memory/learnings.md
New pattern -> .claude/context/memory/learnings.md
Issue found -> .claude/context/memory/issues.md
Decision made -> .claude/context/memory/decisions.md
ASSUME INTERRUPTION: If it's not in memory, it didn't happen.
More from this repository 