Configure

What it does

When your agent uses it

• Rotating the Slack bot and app-level tokens for the slack-channel plugin
• With /slack-channel:configure
• Configure slack tokens
• Set up my slack bot token

Example prompts

• “/slack-channel:configure”
• “configure slack tokens”
• “set up my slack bot token”
• “/configure”

Requirements

• Node.js
• Docker
• A credential in SLACK_BOT_TOKEN
• A credential in SLACK_APP_TOKEN
• Compatibility (from SKILL.md): Requires Claude Code with the slack-channel plugin and a Slack app that already exists (tokens come from api.slack.com/apps); POSIX shell for chmod/mkdir.
• Pre-approved tools (allowed-tools): Write, Bash(chmod:*), Bash(mkdir:*)

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

1. 1Parse the two arguments from $ARGUMENTS
2. 2If either token is missing or has the wrong prefix, show this error and stop
3. 3Create the state directory if it doesn't exist
4. 4Write the .env file at ~/.claude/channels/slack/.env
5. 5Set file permissions to owner-only
6. 6Confirm success

What it can do on your machine

Read from SKILL.md and the folder at commit cfae287. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Write
  • Bash(chmod:*)
  • Bash(mkdir:*)

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Shell commands in SKILL.md call:

  • claude

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Links to these hosts (documentation or services it may open):

  • github.com

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names these keys or tokens, usually read from environment variables:

  • SLACK_BOT_TOKEN
  • SLACK_APP_TOKEN

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

• Compatibility

  Requires Claude Code with the slack-channel plugin and a Slack app that already exists (tokens come from api.slack.com/apps); POSIX shell for chmod/mkdir.

  From compatibility in the SKILL.md frontmatter.

Context cost

Configure loads about 1.3k tokens when it runs. Until then it costs about 66 tokens; SKILL.md has 393 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~66

When it runs · the whole SKILL.md, loaded when a task matches

~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

• NoteMentions a .env fileSKILL.md:20

  writes them to the state directory's `.env`, and locks the file to owner-only

• NoteMentions a .env fileSKILL.md:61

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

• NoteMentions a .env fileSKILL.md:69

  chmod 600 ~/.claude/channels/slack/.env

• NoteMentions a .env fileSKILL.md:89

  - On success: `~/.claude/channels/slack/.env` written with both tokens and

• NoteMentions a .env fileSKILL.md:101

  - **Existing `.env`** — re-running overwrites it in place; this is the

• NoteMentions a .env fileSKILL.md:110

  mand — the second run simply overwrites `.env`:

• NoteMentions a .env fileSKILL.md:116

  the Slack UI — same command, overwrites .env

• NoteMentions a .env fileSKILL.md:123

  tokens to stdout or any file other than `.env`

• NoteMentions a .env fileSKILL.md:124

  - Always set 0o600 permissions on the `.env` file

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jeremylongshore/tons-of-skills-marketplace at commit cfae287, republished under its Apache-2.0 licence (© jeremylongshore). 393 words, ~1,293 tokens.

name

configure

description

Configure Slack channel tokens (bot token + app-level token). Use when writing or rotating the Slack bot and app-level tokens for the slack-channel plugin. Trigger with "/slack-channel:configure", "configure slack tokens", or "set up my slack bot token".

allowed-tools

Write, Bash(chmod:*), Bash(mkdir:*)

compatibility

Requires Claude Code with the slack-channel plugin and a Slack app that already exists (tokens come from api.slack.com/apps); POSIX shell for chmod/mkdir.

version

1.0.1

author

Jeremy Longshore <jeremy@intentsolutions.io>

license

Apache-2.0

tags

slack, tokens, configuration, security

user-invocable

true

argument-hint

<bot-token> <app-token>

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

# First-time setup (tokens copied from api.slack.com/apps)
/slack-channel:configure xoxb-1234567890-EXAMPLE xapp-1-A0EXAMPLE

# Rotation after regenerating tokens in the Slack UI — same command, overwrites .env
/slack-channel:configure xoxb-NEW-TOKEN xapp-NEW-TOKEN

© jeremylongshore, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/mcp/slack-channel/skills/configure of jeremylongshore/tons-of-skills-marketplace.

Open the folder on GitHubat commit cfae287