skills.rest
ceedaragents
ceedaragentsOFFICIAL
Explore all skills by this author →
GitHub

cyrus-setup-slack

Creates a Slack app from a manifest and configures bot credentials for Cyrus.

794|163|Updated Apr 19, 2025
Search Tags:#webhook#Slack#bot token#integration setup#cyrus#oAuth#app manifest
One-click install
npx skills add https://github.com/ceedaragents/cyrus --skill cyrus-setup-slack
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cyrus-setup-slack
Source: https://github.com/ceedaragents/cyrus/tree/main/skills/cyrus-setup-slack
Command: npx skills add https://github.com/ceedaragents/cyrus --skill cyrus-setup-slack

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Setting up a Slack integration for Cyrus requires manually creating a Slack app with the correct OAuth scopes, event subscriptions, and webhook URLs, then securely transferring bot tokens into the Cyrus environment file. This Skill automates and guides that entire process while keeping secrets out of the conversation context.

Core Features & Use Cases

  • Manifest-Based App Creation: Builds a fully substituted Slack app manifest with the correct bot/user scopes, event subscriptions, and the /slack-webhook request URL.
  • Multiple Setup Paths: Supports browser automation via claude-in-chrome or agent-browser, plus a manual guided flow when automation is unavailable.
  • Secret-Safe Credential Handling: Never reads or scrapes secrets; it writes placeholders to ~/.cyrus/.env and guides the user to paste the bot token and signing secret manually.
  • Use Case: During Cyrus self-hosted onboarding, run this Skill to create the Slack app, install it to your workspace, and store SLACK_BOT_TOKEN and SLACK_SIGNING_SECRET without exposing credentials to the AI.

Quick Start

Run the cyrus-setup-slack skill to create my Slack app from the manifest and configure the bot credentials for Cyrus.

Frequently Asked Questions about cyrus-setup-slack

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

FAQPage Schema
How do I create a Slack app for Cyrus?▼

The Skill builds a manifest JSON with your agent name, description, and base URL, then creates the app via the Slack API site's 'From a manifest' flow. It supports browser automation with claude-in-chrome or agent-browser, or a manual guided path.

How do I configure the Slack bot token for Cyrus?▼

After installing the app to your workspace, copy the Bot User OAuth Token (starting with xoxb-) from the OAuth & Permissions page and paste it after SLACK_BOT_TOKEN= in ~/.cyrus/.env. The Skill opens the file for you and verifies the values are non-empty.

What Slack OAuth scopes does the Cyrus app need?▼

The manifest defines bot scopes like chat:write, app_mentions:read, channels:history, files:read, and reactions:write, plus user scopes for search and canvases. These must stay in sync with the scopes defined in the cyrus-hosted repository constants.

Why does the Slack event subscription URL fail verification?▼

Slack's verification challenge fails until Cyrus is actually running and serving the /slack-webhook endpoint. Once Cyrus is started, re-enter the request URL on the Event Subscriptions page or wait for Slack to retry automatically.

Can the agent read my Slack credentials automatically?▼

No. The Skill explicitly forbids reading, scraping, or screenshotting credential pages. It only writes empty placeholders to ~/.cyrus/.env and instructs you to paste the token and signing secret manually.

Related Skills

Explore More Software Engineering Skills→
igmarinigmarin
22

api-postman-collection

Generate and synchronize Postman collection JSON files for Rails API endpoints.

Community
Intermediate
thevibeworksthevibeworks
28

Setup tips & tricks — Slack × CMA webhook bridge

Bridge Slack @mentions to Claude Managed Agent sessions and reply in-thread.

Official
Advanced
bgschillerbgschiller

create-mr

Create GitHub or GitLab pull requests with auto-generated titles and descriptions.

Community
Intermediate
Open330Open330
1

developing-slack-apps

Automate Slack app development with Bolt-based scaffolding and Block Kit UI templates.

Official
Advanced