| name | slack-cli |
| description | Use this skill for service operations only. DO NOT use this skill for CLI implementation lifecycle work such as creating, testing, updating, troubleshooting, validating, removing, or documenting the CLI tool itself; delegate those tasks to cli-tool-expert. Execute slack operations using the `slack` CLI tool. CLI interface for Slack API — messages, channels, DMs, files, notifications, users, canvases, and reminders. Triggers: slack, slack cli, slack messages, slack channels, send slack message, slack DMs, slack files, slack notifications, slack users, slack reminders, slack canvas, read slack, search slack |
Execute slack operations using the `slack` CLI. All slack interactions should use this CLI.
<quick_start>
The slack CLI follows this pattern:
slack <command-group> <action> [arguments] [options]
| Task | Command |
|---|
| Send a message | slack messages send CHANNEL_ID "Hello!" |
| Reply in thread | slack messages send CHANNEL_ID "Reply" --thread-ts TS |
| List channels | slack channels list --table |
| Read channel messages | slack messages list CHANNEL_ID --table |
| Search messages | slack messages search "query" --table |
| Send a DM | slack dm send @user "Hello!" |
| Read DMs | slack dm read @user --table |
| Check notifications | slack notifications list --table |
| Upload a file | slack files upload file.pdf --channels CHANNEL_ID |
| List users | slack users list --table |
| Set your profile photo | slack users set-photo avatar.png |
| </quick_start> | |
<essential_principles>
MANDATORY: Consult the adjacent usage.json at <cli-tools-root>/_repo/skills/<tool>-cli/usage.json before executing ANY slack command.
This file contains complete command syntax, all arguments, all options, and usage instructions for every command. Never guess at command syntax.
- **auth** — Manage Slack API authentication (login, logout, status, refresh, test)
- **cache** — Manage CLI response cache
- **canvas** — Manage Slack canvases (list, get content)
- **channels** — Manage channels (list, get, create, archive, join, leave, members)
- **dm** — Direct messages (list, get, send, read history)
- **files** — Manage files (list, upload, get, delete, download)
- **messages** — Messages (send, get, list, search, delete, mentions, threads)
- **notifications** — View notifications (get, counts, list, summary)
- **auth** -- Authentication commands and nested `auth profiles` management
- **users** — Manage users (list, get, set-status, set-photo)
- **reminders** — Reminders and saved items/Later (list, get, complete, new, delete)
Slack uses mrkdwn, not standard markdown. Bold = `*text*` (single asterisk). Links = ``. Always use mrkdwn when composing messages.
<reference_index>
usage.json — Complete command tree with arguments, options, defaults, and usage instructions for every command.
</reference_index>
<success_criteria>
- Command executes without error
- Output is displayed in requested format
- Correct command and flags used (verified against usage.json)
</success_criteria>
