Skip to main content
AI/MLjeremylongshore

configure

Configure Slack channel tokens (bot token + app-level token)

Stars
2,267
Source
jeremylongshore/claude-code-plugins-plus-skills
Updated
2026-05-31
Slug
jeremylongshore--claude-code-plugins-plus-skills--configure
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/jeremylongshore/claude-code-plugins-plus-skills/HEAD/plugins/mcp/slack-channel/skills/configure/SKILL.md -o .claude/skills/configure.md

Drops the SKILL.md into .claude/skills/configure.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

/slack-channel:configure

Configure the Slack channel with your bot token and app-level token.

Usage

/slack-channel:configure <xoxb-bot-token> <xapp-app-token>

Instructions

  1. Parse the two arguments from $ARGUMENTS:

    • First token must start with xoxb- (Bot User OAuth Token)
    • Second token must start with xapp- (App-Level Token)
  2. If either token is missing or has the wrong prefix, show this error and stop:

    Error: Two tokens required.
      - Bot token (starts with xoxb-) from OAuth & Permissions
      - App token (starts with xapp-) from Socket Mode settings
    
    Usage: /slack-channel:configure xoxb-... xapp-...
    
  3. Create the state directory if it doesn't exist:

    ~/.claude/channels/slack/
    
  4. Write the .env file at ~/.claude/channels/slack/.env:

    SLACK_BOT_TOKEN=<bot-token>
    SLACK_APP_TOKEN=<app-token>
    
  5. Set file permissions to owner-only:

    chmod 600 ~/.claude/channels/slack/.env
    
  6. Confirm success:

    Slack channel configured.
    
    Start Claude with the Slack channel:
      claude --channels plugin:slack-channel@claude-code-plugins
    
    Or for development:
      claude --dangerously-load-development-channels server:slack
    

Security

  • Never echo the tokens back in the confirmation message
  • Never log tokens to stdout or any file other than .env
  • Always set 0o600 permissions on the .env file