szrabinowitz/slackscope · Archived

slack-cli-read

Access Slack through the global `slack` CLI for read-only workflows. Use when asked to list chats or DMs, read message history, inspect threads, fetch exact messages, or summarize recent Slack activity.

First seen Feb 12, 2026

Installation

$ npx skills add szrabinowitz/slackscope --skill slack-cli-read

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Default branch main
Open issues 0
Status Archived

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,607 B
  • docs SUMMARY.md 224 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 45 installs

SKILL.md

slack-cli-read

Use this skill to read Slack content via the global slack command.

Scope

  • Read-only commands are supported.
  • Writing/sending/replying is not implemented yet. If asked to write, state that it is not available yet and offer to draft message text only.

Environment

  • Assume slack is available as a global command.
  • Slack credentials are expected at ~/.config/slack/slack.env.
  • Required variables:

- SLACKWORKSPACE - TOKEN - DCOOKIE

  • If auth fails or env vars are missing, help the user populate that file.

Command Map

  • Login bootstrap (interactive): slack auth login <workspace>
  • Auth diagnostics: slack auth status
  • Verify auth/workspace: slack me
  • List all conversations: slack chat list
  • List unread conversations: slack chat list --unread
  • List DM inbox: slack dm list
  • List unread DMs: slack dm list --unread
  • Read chat history: slack chat history "<chat>" --limit 30
  • Read DM history: slack dm history <userordm_id> --limit 30
  • Read full thread: slack thread show <chatordm> <thread_ts>
  • Read one full message: slack chat message <chatordm> <ts>
  • Search users: slack users list --query <text>
  • Raw API call (expert mode): slack api call <endpoint> -p key=value
  • Raw API curl wrapper (expert mode): slack api curl <endpoint> -- [curl args]

Working Style

  1. Start broad with chat list or dm list when intent is vague.
  2. Narrow into history with a bounded --limit.
  3. Expand parent threads via thread show when inline replies are truncated.
  4. Fetch exact messages with chat message when full text is needed.

Command Hygiene

  • Quote names starting with # in shell commands, for example: slack chat history "#general".
  • Prefer IDs when names are ambiguous.
  • Keep commands bounded with --limit unless the user asks for more.
  • Use pretty output for human reading.
  • Use --format json or --format jsonl for structured parsing.
  • Use slack api call/slack api curl only when typed commands do not cover the needed endpoint behavior.
  • If auth fails, run slack auth status before retrying read commands.

Response Guidance

  • Summarize key findings instead of dumping raw command output.
  • Keep timestamps and IDs in results when they help the user drill down.
  • Treat attachment lines (📎 ...) as message context.