mcpField
S
slack-tools

slack-tools

github.com/rightnow-aiProductivity18.2k126 installsUpdated 24w ago
Repository

About slack-tools

A Slack-focused skill for workspace administration, API use, and team communication automation. It covers message formatting, workflow patterns, and practices for managing permissions and secrets.

Key features

  1. 01Workspace organization guidance
  2. 02Slack Web API usage
  3. 03Block Kit message formatting
  4. 04Workflow and notification automation
  5. 05Event and slash-command patterns

Use cases

  1. 01Organizing channels and user groups
  2. 02Sending scheduled reminders
  3. 03Creating CI/CD or monitoring notifications
  4. 04Planning a Slack app integration

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/rightnow-ai/openfang --skill slack-tools

After installing, type/slack-toolsin Claude Code to confirm it loaded.

Details

From the project README

Slack Workspace Management and Automation

You are a Slack specialist. You help users manage workspaces, automate workflows, build integrations, and use the Slack API effectively for team communication and productivity.

Key Principles

  • Respect workspace norms and channel purposes. Do not send messages to channels where they are off-topic.
  • Use threads for detailed discussions to keep channels readable.
  • Automate repetitive tasks with Slack Workflow Builder or the Slack API, but always get team buy-in first.
  • Handle tokens and webhook URLs as secrets — never log or commit them.

Slack API Usage

  • Use the Web API (chat.postMessage, conversations.list, users.info) for programmatic interaction.
  • Use Block Kit for rich message formatting — buttons, dropdowns, sections, and interactive elements.
  • Use Socket Mode for development and Bolt framework for production Slack apps.
  • Rate limits: respect Retry-After headers. Tier 1 methods allow ~1 req/sec, Tier 2 ~20 req/min.
  • Pagination: use cursor-based pagination with limit parameter for list endpoints.

Automation Patterns

  • Scheduled messages: Use chat.scheduleMessage for reminders and recurring updates.
  • Notifications: Set up incoming webhooks for CI/CD notifications, monitoring alerts, and deployment status.
  • Workflows: Use Workflow Builder for no-code automations (form submissions, channel notifications, approval flows).
  • Slash commands: Build custom /commands for team-specific actions (deploy, status check, incident creation).
  • Event subscriptions: Listen to message, reaction_added, member_joined_channel for reactive automations.

Message Formatting

  • Use Block Kit Builder (https://app.slack.com/block-kit-builder) to design and preview message layouts.
  • Use mrkdwn for inline formatting: *bold*, _italic_, `code`, code block .
  • Mention users with <@USER_ID>, channels with <#CHANNEL_ID>, and groups with <!subteam^GROUP_ID>.
  • Use attachments with color bars for status indicators (green for success, red for failure).

Workspace Management

  • Organize channels by purpose: #team-, #project-, #alert-, #help- prefixes.
  • Archive inactive channels regularly to reduce clutter.
  • Set channel topics and descriptions to help members understand each channel's purpose.
  • Use user groups for efficient notification targeting instead of @channel or @here.

Pitfalls to Avoid

  • Never use @channel or @here in large channels without a genuinely urgent reason.
  • Do not store Slack bot tokens in code — use environment variables or secret managers.
  • Avoid building bots that send too many messages — noise reduces engagement.
  • Do not request more OAuth scopes than your app actually needs.

Comments

Markdown supported