Slack Notifications

Name: Slack Notifications
Author: oimiragieo

oimiragieo/agent-studio

289 installs
36 repo stars
Updated July 14, 2026
oimiragieo/agent-studio

Post build status, review requests, or agent milestones to Slack channels so teams get real-time alerts from CI, deploys, or long-running agent jobs without building custom bots from scratch.

About

slack-notifications skill helps agents integrate Slack messaging—webhooks, blocks, and channel routing—so development and automation pipelines surface actionable updates to engineering channels during build and review cycles.

Send formatted messages to channels or users
Attach build logs or summary blocks
Trigger on agent task completion
Configure webhooks and bot tokens safely
Template alerts for deploy and review events

Slack Notifications by the numbers

289 all-time installs (skills.sh)
Ranked #494 of 2,715 Automation & Workflows skills by installs in the Skillselion catalog
Data as of Aug 4, 2026 (Skillselion catalog sync)

npx skills add https://github.com/oimiragieo/agent-studio --skill slack-notifications

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/skills/oimiragieo/agent-studio/slack-notifications.svg)](https://skillselion.com/skills/oimiragieo/agent-studio/slack-notifications)

Installs	289
repo stars	★ 36
Last updated	July 14, 2026
Repository	oimiragieo/agent-studio ↗

What it does

Post build status, review requests, or agent milestones to Slack channels so teams get real-time alerts from CI, deploys, or long-running agent jobs without building custom bots from scratch.

Files

SKILL.mdMarkdownGitHub ↗

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

1. Create a Slack App at <https://api.slack.com/apps> 2. Navigate to "OAuth & Permissions" 3. Add required bot token scopes:

chat:write - Send messages
channels:read - List channels
channels:history - Read channel history
users:read - List users
files:write - Upload files
reactions:write - Add reactions

4. Install app to workspace 5. 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

# Post message to channel
curl -X POST https://slack.com/api/chat.postMessage \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"channel": "C1234567890", "text": "Hello from Claude!"}'

# List channels
curl -X GET "https://slack.com/api/conversations.list" \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN"

# Upload file
curl -X POST https://slack.com/api/files.upload \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
  -F "channels=C1234567890" \
  -F "file=@report.pdf" \
  -F "title=Weekly Report"

Tool Details

Messaging Tools (Confirmation Required)

post-message

Send a message to a Slack channel.

Parameters:

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 threading
blocks (optional): Rich message blocks (JSON array)

Example:

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.

Parameters:

channel (required): Channel ID
thread_ts (required): Parent message timestamp
text (required): Reply text

Example:

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.

Parameters:

channel (required): Channel ID
ts (required): Message timestamp
text (required): New message text

Example:

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

Delete a message.

Parameters:

channel (required): Channel ID
ts (required): Message timestamp

Example:

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.

Parameters:

types (optional): Comma-separated channel types (default: "public_channel")
Options: "public_channel", "private_channel", "mpim", "im"
limit (optional): Max channels to return (default: 100)

Example:

curl -X GET "https://slack.com/api/conversations.list?types=public_channel,private_channel" \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN"

get-channel

Get channel information.

Parameters:

channel (required): Channel ID

Example:

curl -X GET "https://slack.com/api/conversations.info?channel=C1234567890" \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN"

channel-history

Get channel message history.

Parameters:

channel (required): Channel ID
limit (optional): Max messages to return (default: 100)
oldest (optional): Start of time range (Unix timestamp)
latest (optional): End of time range (Unix timestamp)

Example:

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.

File Tools

upload-file (Confirmation Required)

Upload a file to Slack channel.

Parameters:

channels (required): Comma-separated channel IDs
file (required): File path to upload
title (optional): File title
initial_comment (optional): Message text

Example:

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

List files in channel.

Parameters:

channel (optional): Channel ID to filter by
user (optional): User ID to filter by
count (optional): Max files to return (default: 100)

Example:

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.

Parameters:

channel (required): Channel ID
timestamp (required): Message timestamp
name (required): Emoji name (without colons, e.g., "thumbsup")

Example:

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.

Parameters:

channel (required): Channel ID
timestamp (required): Message timestamp

Example:

curl -X GET "https://slack.com/api/reactions.get?channel=C1234567890&timestamp=1234567890.123456" \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN"

Agent Integration

Primary Agents

devops: Infrastructure alerts, deployment notifications, monitoring
incident-responder: Incident alerts, status updates, escalations

Secondary Agents

pm: Sprint notifications, milestone updates, team announcements
developer: Build notifications, PR alerts, test results
qa: Test failure alerts, quality reports
security-architect: Security alerts, vulnerability notifications

Common Use Cases

Deployment Notifications

# Notify channel of successful deployment
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

# Alert on-call team of incident
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

# Post 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 messages
Store 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_authed`	Missing or invalid token	Check `SLACK_BOT_TOKEN` is set correctly
`channel_not_found`	Invalid channel ID	Verify channel ID with `list-channels`
`missing_scope`	Bot lacks required permission	Add scope in Slack App settings
`rate_limited`	Too many requests	Implement exponential backoff
`message_not_found`	Invalid timestamp	Check message timestamp is correct

Retry Strategy

For rate limiting errors, implement exponential backoff:

1. Wait 1 second, retry 2. Wait 2 seconds, retry 3. Wait 4 seconds, retry 4. Wait 8 seconds, retry 5. Give up after 5 attempts

Rate Limits

Slack API rate limits:

Tier 1: 1 request per second
Tier 2: 20 requests per minute
Tier 3: 50 requests per minute
Tier 4: 100 requests per minute

Methods by tier:

chat.postMessage: Tier 3 (50/min)
conversations.list: Tier 2 (20/min)
users.list: Tier 2 (20/min)
files.upload: Tier 4 (100/min)

Slack API Documentation: <https://api.slack.com/docs>
Block Kit Builder: <https://app.slack.com/block-kit-builder>
Slack App Management: <https://api.slack.com/apps>

Memory Protocol (MANDATORY)

Before starting: Read .claude/context/memory/learnings.md

After completing:

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.

#!/usr/bin/env node

/**
 * slack-notifications - Post-Execute Hook
 * Runs after the skill executes for cleanup, logging, or follow-up actions.
 */

const fs = require('fs');
const path = require('path');
const { safeParseJSON } = require('../../../lib/utils/safe-json.cjs');

// Parse hook input
const result = safeParseJSON(process.argv[2] || '{}');

console.log('📝 [SLACK-NOTIFICATIONS] Post-execute processing...');

/**
 * Process execution result
 */
function processResult(_result) {
  // TODO: Add your post-processing logic here

  return { success: true };
}

// Run post-processing
const outcome = processResult(result);

if (outcome.success) {
  console.log('✅ [SLACK-NOTIFICATIONS] Post-processing complete');
  process.exit(0);
} else {
  console.error('⚠️  [SLACK-NOTIFICATIONS] Post-processing had issues');
  process.exit(0);
}

#!/usr/bin/env node

/**
 * slack-notifications - Pre-Execute Hook
 * Runs before the skill executes to validate input or prepare context.
 */

const fs = require('fs');
const path = require('path');
const { safeParseJSON } = require('../../../lib/utils/safe-json.cjs');

// Parse hook input
const input = safeParseJSON(process.argv[2] || '{}');

console.log('🔍 [SLACK-NOTIFICATIONS] Pre-execute validation...');

/**
 * Validate input before execution
 */
function validateInput(_input) {
  const errors = [];

  // TODO: Add your validation logic here

  return errors;
}

// Run validation
const errors = validateInput(input);

if (errors.length > 0) {
  console.error('❌ Validation failed:');
  errors.forEach(e => console.error('   - ' + e));
  process.exit(1);
}

console.log('✅ [SLACK-NOTIFICATIONS] Validation passed');
process.exit(0);

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "slack-notifications Input Schema",
  "description": "Input validation schema for slack-notifications skill",
  "type": "object",
  "required": [],
  "properties": {},
  "additionalProperties": true
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "slack-notifications Output Schema",
  "description": "Output validation schema for slack-notifications skill",
  "type": "object",
  "required": ["success"],
  "properties": {
    "success": {
      "type": "boolean",
      "description": "Whether the skill executed successfully"
    },
    "result": {
      "type": "object",
      "description": "The skill execution result",
      "additionalProperties": true
    },
    "error": {
      "type": "string",
      "description": "Error message if execution failed"
    }
  },
  "additionalProperties": true
}

#!/usr/bin/env node

/**
 * Slack Notifications - Main Script
 * 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.
 *
 * Usage:
 *   node main.cjs [options]
 *
 * Options:
 *   --help     Show this help message
 */

const fs = require('fs');
const path = require('path');

// Find project root
function findProjectRoot() {
  let dir = __dirname;
  while (dir !== path.parse(dir).root) {
    if (fs.existsSync(path.join(dir, '.claude'))) {
      return dir;
    }
    dir = path.dirname(dir);
  }
  return process.cwd();
}

const PROJECT_ROOT = findProjectRoot();

// Parse command line arguments
const args = process.argv.slice(2);
const options = {};
for (let i = 0; i < args.length; i++) {
  if (args[i].startsWith('--')) {
    const key = args[i].slice(2);
    const value = args[i + 1] && !args[i + 1].startsWith('--') ? args[++i] : true;
    options[key] = value;
  }
}

/**
 * Main execution
 */
function main() {
  if (options.help) {
    console.log(`
Slack Notifications - Main Script

Usage:
  node main.cjs [options]

Options:
  --help     Show this help message
`);
    process.exit(0);
  }

  console.log(
    'Slack Notifications skill provides in-context guidance; configure Slack MCP/API for full functionality. Invoke via the agent; no standalone script.'
  );
  process.exit(0);
}

main();

Related skills

Agent BrowserGive their coding agent reliable, high-fidelity control over any website or Electron desktop app.591k39.6k

Lark ApprovalLet their AI coding agent create, read, update, and approve items in Lark (Feishu) approval workflows without leaving the coding environment.494k

Lark EventHandle Feishu/Lark bot events, webhooks, and subscription callbacks in agent-driven backend code.493k

Lark Workflow Meeting SummaryAutomatically generate structured meeting summaries and action items from Lark/Feishu calls without manual note-taking.492k

Lark Workflow Standup ReportAutomatically generate and post daily standup reports in Lark/Feishu from their workflow and activity data.492k

Twitter AutomationAutomate X/Twitter posts, scheduling, and engagement via X API integration441k669

Automation & Workflowsintegrationsbackend

About

Slack Notifications by the numbers

Add your badge

What it does

Files

Slack Notifications Skill

Overview

Requirements

Setting up Slack Bot Token

Tools

Quick Reference

Tool Details

Messaging Tools (Confirmation Required)

post-message

post-thread

update-message

delete-message

Channel Tools

list-channels

get-channel

channel-history

User Tools

list-users

get-user

user-presence

File Tools

upload-file (Confirmation Required)

list-files

Reaction Tools

add-reaction

get-reactions

Agent Integration

Primary Agents

Secondary Agents

Common Use Cases

Deployment Notifications

Incident Alerts

Test Results

Security Considerations

Token Security

Message Security

Data Privacy

Error Handling

Common Errors

Retry Strategy

Rate Limits

Related

Memory Protocol (MANDATORY)

slack-notifications Research Requirements

Skill Description

Research Areas

Source References

slack-notifications Rules

Purpose

Best Practices

Integration Points

slack-notifications Implementation Template

Goal

TDD

Verification

Related skills

This week in AI coding