hive.slack-notifications-setup

Configures a Slack app with bot and app-level tokens to enable colony alert notifications.

11.0k|5.7k|Updated Jan 12, 2026
One-click install
npx skills add https://github.com/aden-hive/hive --skill hive-slack-notifications-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hive.slack-notifications-setup
Source: https://github.com/aden-hive/hive/tree/main/core/framework/skills/_default_skills/slack-notifications-setup
Command: npx skills add https://github.com/aden-hive/hive --skill hive-slack-notifications-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Setting up Slack notifications for an agent colony normally requires manually creating a Slack app, configuring OAuth scopes, generating tokens, and wiring up a channel. This Skill automates that entire flow by driving the user's browser and the Slack API, so the colony can ping the user on Slack and receive replies without any copy-pasting of credentials.

Core Features & Use Cases

  • Automated Slack App Provisioning: Reuses or creates the "Hive Sentinel" Slack app from a JSON manifest with the correct bot scopes, Socket Mode, and event subscriptions.
  • Token Capture and Storage: Reads the bot token (xoxb-) and app-level token (xapp-) directly from the Slack dashboard and stores them via the sentinel_setup tool.
  • Channel Management via Slack API: Creates or selects a notification channel using conversations.create, conversations.list, and conversations.invite, then enables and tests Sentinel.
  • Use Case: A user clicks "Set this up with the agent" on the Slack channel step, and the agent completes the whole setup — app creation, token storage, channel creation, and a test message — in one session.

Quick Start

Ask the agent to set up Slack notifications for my colony so I get pinged on Slack when it stalls.

Frequently Asked Questions about hive.slack-notifications-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up Slack notifications for a Hive colony?

Activate this skill and it drives your browser to create or reuse the Hive Sentinel Slack app, captures the bot and app-level tokens, creates a channel via the Slack API, and enables Sentinel. No manual token copying is required.

What Slack tokens are needed for Sentinel notifications?

Two tokens are required: a Bot User OAuth Token (xoxb-) for sending alerts and calling the Slack API, and an App-Level Token (xapp-) with connections:write scope for Socket Mode to receive user replies.

Does this skill create a duplicate Slack app if one already exists?

No. It first checks sentinel_setup status and scans the apps list for an existing Hive Sentinel app. If found, it reuses that app and skips creation entirely.

Why does the Slack manifest editor show doubled content or a disabled Next button?

Slack's CodeMirror editor validates from React state, so typing or pasting text appends duplicates. The skill sets the value once via cm.setValue and fires a value-less input event to sync React state.

Can I use an existing Slack channel instead of creating a new one?

Yes. The skill lists channels with conversations.list to find the channel id, then invites the bot via conversations.invite so it can post alerts and read replies in that channel.

What happens if the Slack workspace requires admin approval for apps?

The skill cannot bypass org admin approval walls. It will tell the user to request admin approval or use a workspace where they have admin privileges.