Cyrus Setup Slack

Sets up a Slack bot integration for Cyrus by creating an app from a pre-built manifest that includes OAuth scopes, event subscriptions, and webhook endpoints. The skill takes your base URL, agent name, and description, then either automates the process through browser control (claude-in-chrome or agent-browser) or walks you through it manually. It's opinionated about security: credentials never get read into context, only written via bash commands. The manifest defines specific scopes for channels, search, canvases, and reactions, routing events to /slack-webhook. Worth noting it checks if you're already configured and bails early if so. This is the first-time setup step, not ongoing Slack operations.

skills.sh installs: 161
GitHub stars: 615
last updated: Jun 3, 2026

View on GitHub

Install

$ npx -y skills add ceedaragents/cyrus --skill cyrus-setup-slack --agent claude-code

Installs into .claude/skills of the current project.

Files

CRITICAL: Never use Read, Edit, or Write tools on ~/.cyrus/.env or any file inside ~/.cyrus/. Use only Bash commands (grep, printf >>, etc.) to interact with env files — secrets must never be read into the conversation context. Never scrape, extract, or read secret values from web pages — guide the user to copy them manually.

Setup Slack

Creates a Slack application from a pre-built manifest so Cyrus can respond to messages in Slack channels.

Step 1: Check Existing Configuration

grep -E '^SLACK_BOT_TOKEN=' ~/.cyrus/.env 2>/dev/null

If SLACK_BOT_TOKEN is already set, inform the user:

Slack is already configured. Skipping this step. To reconfigure, remove SLACK_BOT_TOKEN and SLACK_SIGNING_SECRET from ~/.cyrus/.env and re-run.

Skip to completion.

Step 2: Read Variables

Read the base URL (set by setup-endpoint):

grep '^CYRUS_BASE_URL=' ~/.cyrus/.env | cut -d= -f2-

You also need AGENT_NAME and AGENT_DESCRIPTION — these were collected in Step 0 of the orchestrator and should be available from the conversation context.