Agent-Skills.md

Agent Skills: Slack CLI (slacker) Skill

Interact with Slack (reminders, DMs, activity, saved messages)

UncategorizedID: benthomasson/claude-skills/slacker

Repository

benthomasson/claude-skills
benthomassonLicense: MIT
12

Install this agent skill to your local

pnpm dlx add-skill https://github.com/benthomasson/claude-skills/tree/HEAD/skills/slacker

Skill Files

Browse the full folder contents for slacker.

Download Skill

Loading file tree…

skills/slacker/SKILL.md

Skill Metadata

Name
slacker
Description
Interact with Slack (reminders, DMs, activity, saved messages)

Slack CLI (slacker) Skill

Quick reference for using slacker CLI tool to interact with Slack programmatically.

Repository: https://github.com/shanemcd/slacker

Quick Start

The easiest way to use slacker is with uvx - no installation or repository cloning required:

# List reminders and saved messages
uvx --from "git+https://github.com/shanemcd/slacker" slacker reminders

# Create a reminder
uvx --from "git+https://github.com/shanemcd/slacker" slacker reminder "me to call mom tomorrow at 9am"

# List today's DMs
uvx --from "git+https://github.com/shanemcd/slacker" slacker dms

# View activity feed (mentions, threads, reactions)
uvx --from "git+https://github.com/shanemcd/slacker" slacker activity

# Check authentication
uvx --from "git+https://github.com/shanemcd/slacker" slacker whoami

Tip: Add an alias to your shell for convenience:

alias slacker='uvx --from "git+https://github.com/shanemcd/slacker" slacker'

# Then use it simply:
slacker reminders
slacker reminder "me to review PR in 30 minutes"

Overview

slacker extracts Slack authentication credentials from your browser session, enabling programmatic access to Slack APIs without creating a bot or app.

When to Use This Skill

Use this skill when:

  • User asks to create a Slack reminder
  • User wants to check their reminders or saved messages
  • User asks about recent DMs or Slack activity
  • User mentions Slack mentions, threads, or reactions
  • User wants to search Slack messages
  • User asks about their Slack notes or saved items

Authentication

First-Time Setup

# Extract credentials from your browser session
uvx --from "git+https://github.com/shanemcd/slacker" slacker login https://redhat.enterprise.slack.com

# Test authentication
uvx --from "git+https://github.com/shanemcd/slacker" slacker whoami

Credentials are stored at ~/.config/slacker/credentials with 0600 permissions (read-only by owner).

Common Commands

Create Reminders

Create reminders using natural language - works exactly like typing /remind in Slack:

# Standard format: "me to [task] [when]"
uvx --from "git+https://github.com/shanemcd/slacker" slacker reminder "me to call mom tomorrow at 9am"
uvx --from "git+https://github.com/shanemcd/slacker" slacker reminder "me to review PR in 30 minutes"
uvx --from "git+https://github.com/shanemcd/slacker" slacker reminder "me to check status next Monday"

# Can omit "me to" - Slack will figure it out
uvx --from "git+https://github.com/shanemcd/slacker" slacker reminder "call mom tomorrow"
uvx --from "git+https://github.com/shanemcd/slacker" slacker reminder "team sync prep Monday at 2pm"

# Recurring reminders
uvx --from "git+https://github.com/shanemcd/slacker" slacker reminder "me to do weekly planning every Monday at 9am"

Natural language parsing by Slack: Slack automatically parses the text to extract the task and timing. Supported formats:

  • Relative: "in 30 minutes", "in 2 hours", "in 3 days"
  • Absolute: "tomorrow", "next Monday", "Friday at 3pm"
  • Combined: "tomorrow at 9am", "next week on Tuesday"
  • Recurring: "every weekday", "every Monday at 9am"

List Reminders and Saved Items

# List all saved items (reminders + saved messages)
uvx --from "git+https://github.com/shanemcd/slacker" slacker reminders

# List only reminders (exclude saved messages)
uvx --from "git+https://github.com/shanemcd/slacker" slacker reminders --reminders-only

# Limit results
uvx --from "git+https://github.com/shanemcd/slacker" slacker reminders --limit 10

# JSON output for programmatic processing
uvx --from "git+https://github.com/shanemcd/slacker" slacker --output json reminders

Text output includes:

  • Reminder text and due date
  • Saved message preview (100 chars) with full message text
  • Channel names and message links
  • Status (in_progress, completed)
  • Summary counts (total, uncompleted, overdue, completed)

JSON output includes:

  • Full message text (not truncated!)
  • All metadata (timestamps, channel IDs, states)
  • Structured data for easy parsing with jq

List DMs

View direct messages and group DMs with Slack usernames:

# List today's DM activity (default)
uvx --from "git+https://github.com/shanemcd/slacker" slacker dms

# List DMs since a specific time (natural language)
uvx --from "git+https://github.com/shanemcd/slacker" slacker dms --since "yesterday"
uvx --from "git+https://github.com/shanemcd/slacker" slacker dms --since "2 days ago"
uvx --from "git+https://github.com/shanemcd/slacker" slacker dms --since "last Monday"
uvx --from "git+https://github.com/shanemcd/slacker" slacker dms --since "3 hours ago"

# JSON output for programmatic processing
uvx --from "git+https://github.com/shanemcd/slacker" slacker --output json dms --since "yesterday"

Text output shows:

  • Individual DMs with direction (incoming/outgoing)
  • Group DMs with participant activity
  • Slack usernames (handles) for each person
  • Message timestamps (HH:MM format)
  • Message preview (80 chars)
  • File attachment indicators
  • Summary counts

View Activity Feed

Show mentions, threads, and reactions from your Slack activity with enriched details:

# View all activity (mentions, threads, reactions)
uvx --from "git+https://github.com/shanemcd/slacker" slacker activity

# Filter by activity type
uvx --from "git+https://github.com/shanemcd/slacker" slacker activity --tab mentions
uvx --from "git+https://github.com/shanemcd/slacker" slacker activity --tab threads
uvx --from "git+https://github.com/shanemcd/slacker" slacker activity --tab reactions

# JSON output for programmatic processing
uvx --from "git+https://github.com/shanemcd/slacker" slacker --output json activity --tab mentions

Activity types:

  • all - All activity (mentions, threads, reactions, invitations, etc.)
  • mentions - Only @mentions, @channel, @everyone, and keywords
  • threads - Only thread replies
  • reactions - Only emoji reactions to your messages

Text output features:

  • Activity type (mention, thread reply, reaction, etc.)
  • Timestamp (YYYY-MM-DD HH:MM format)
  • Channel name (resolved from channel IDs)
  • Actual usernames (e.g., @jwong, @marturne)
  • Actual team names (e.g., @aap-mcp-squad)
  • Rendered emojis for standard emojis
  • Message preview (80 characters of actual message text)
  • Clean formatting (Slack markup removed)
  • Unread indicator (bullet for unread items)

Search Messages

# Search your own messages (notes to self)
uvx --from "git+https://github.com/shanemcd/slacker" slacker api search.messages --data '{"query": "from:@shanemcd to:@shanemcd", "count": 20, "sort": "timestamp", "sort_dir": "desc"}'

# Search in specific channel
uvx --from "git+https://github.com/shanemcd/slacker" slacker api search.messages --data '{"query": "in:#engineering important"}'

Make Generic API Calls

IMPORTANT: Use --params for GET requests and --data for POST requests:

  • --params sends query parameters (for GET endpoints like conversations.replies, conversations.history, users.info)
  • --data sends JSON body (for POST endpoints like chat.postMessage, search.messages)
# GET request with parameters (conversations.replies, conversations.history, users.info, etc.)
uvx --from "git+https://github.com/shanemcd/slacker" slacker api users.list --params '{"limit": 10}'
uvx --from "git+https://github.com/shanemcd/slacker" slacker api conversations.replies --params '{"channel":"C05S34J4EE9","ts":"1765902174.251099","limit":"100"}'
uvx --from "git+https://github.com/shanemcd/slacker" slacker api conversations.history --params '{"channel":"C12345678","limit":"20"}'

# POST request with data (chat.postMessage, search.messages, etc.)
uvx --from "git+https://github.com/shanemcd/slacker" slacker api chat.postMessage --data '{"channel":"general","text":"Hello!"}'

# Post to your notes channel
uvx --from "git+https://github.com/shanemcd/slacker" slacker api chat.postMessage --data '{"channel":"D19Q000SE","text":"Remember to update slides for tomorrow"}'

Note: User IDs in the output are automatically resolved to usernames.

Discover Available API Methods

# List all API categories
uvx --from "git+https://github.com/shanemcd/slacker" slacker discover

# Filter by category
uvx --from "git+https://github.com/shanemcd/slacker" slacker discover --category chat

# Show all methods
uvx --from "git+https://github.com/shanemcd/slacker" slacker discover --verbose

JSON Output & Processing

All major commands support JSON output via the --output json flag for programmatic processing.

# Get reminders as structured data
uvx --from "git+https://github.com/shanemcd/slacker" slacker --output json reminders

# Get only overdue reminders with jq
uvx --from "git+https://github.com/shanemcd/slacker" slacker --output json reminders --reminders-only | \
  jq --arg now "$(date +%s)" '.items[] | select(.due_timestamp < ($now|tonumber)) | {text, due_date}'

# List all saved messages with full text
uvx --from "git+https://github.com/shanemcd/slacker" slacker --output json reminders | \
  jq '.items[] | select(.type == "message") | .message'

# Get summary counts
uvx --from "git+https://github.com/shanemcd/slacker" slacker --output json reminders | jq '.counts'

Common Workflow Examples

Morning Routine - Check Reminders

# List today's reminders
uvx --from "git+https://github.com/shanemcd/slacker" slacker reminders --reminders-only

Check Recent DM Activity

# Morning routine: check DMs since yesterday
uvx --from "git+https://github.com/shanemcd/slacker" slacker dms --since "yesterday"

# After a meeting: check what you missed in the last hour
uvx --from "git+https://github.com/shanemcd/slacker" slacker dms --since "1 hour ago"

# Monday morning: catch up on weekend messages
uvx --from "git+https://github.com/shanemcd/slacker" slacker dms --since "last Friday"

Check Your Activity

# Morning routine: check all mentions and threads
uvx --from "git+https://github.com/shanemcd/slacker" slacker activity

# See who's reacting to your messages
uvx --from "git+https://github.com/shanemcd/slacker" slacker activity --tab reactions

# Check only @mentions to catch up quickly
uvx --from "git+https://github.com/shanemcd/slacker" slacker activity --tab mentions

Quick Note Taking

# Post to your notes channel
uvx --from "git+https://github.com/shanemcd/slacker" slacker api chat.postMessage --data '{"channel":"D19Q000SE","text":"Remember to update slides for tomorrow"}'

# Create reminder from note
uvx --from "git+https://github.com/shanemcd/slacker" slacker reminder "me to update slides tomorrow at 8am"

Review Past Notes

# Search your notes from last week (POST endpoint - uses --data)
uvx --from "git+https://github.com/shanemcd/slacker" slacker api search.messages --data '{"query":"from:@shanemcd to:@shanemcd after:7d"}'

# Get recent messages from notes channel (GET endpoint - uses --params)
uvx --from "git+https://github.com/shanemcd/slacker" slacker api conversations.history --params '{"channel":"D19Q000SE","limit":"20"}'

Key API Endpoints

Reminders & Later Items

saved.list - List saved items from Slack "Later"

uvx --from "git+https://github.com/shanemcd/slacker" slacker api saved.list --data '{"filter":"saved","limit":50,"include_tombstones":true}'

Messages

search.messages - Search messages

  • Supports JQL-like query syntax
  • Filters: from:, to:, in:, date ranges
  • Sorts by timestamp, relevance

conversations.history - Get message history

  • Requires channel ID
  • Returns messages with full metadata
  • Supports pagination with limit and cursor

Channel IDs

Personal notes channel (notes to self): D19Q000SE

To find other channel IDs:

  1. Right-click channel in Slack -> "View channel details"
  2. Copy channel ID from the details dialog
  3. Or use search: search.messages queries reveal channel IDs in results

Enterprise Restrictions

Red Hat Enterprise Slack workspace has restrictions on certain API endpoints:

Restricted endpoints:

  • reminders.list - Blocked (use saved.list instead)
  • conversations.list - Blocked
  • users.conversations - Blocked

Working alternatives:

  • Use saved.list for reminders
  • Use search.messages to find conversations
  • Use channel IDs directly when known

Troubleshooting

Authentication Expired

If whoami fails, re-extract credentials:

uvx --from "git+https://github.com/shanemcd/slacker" slacker login https://redhat.enterprise.slack.com

Credentials expire when you log out of Slack in your browser.

Enterprise Restrictions

If an API endpoint returns "error": "enterprise_is_restricted", the endpoint is blocked by workspace admin policies. Look for alternative endpoints (e.g., saved.list instead of reminders.list).

Channel Not Found

Ensure you're using the correct channel ID format:

  • DM/notes: D prefix (e.g., D19Q000SE)
  • Public channel: C prefix (e.g., C1234567890)
  • Private channel: G prefix (e.g., G1234567890)

Security Notes

  • Credentials stored locally at ~/.config/slacker/credentials
  • File permissions: 0600 (owner read/write only)
  • Credentials tied to your browser session
  • Expire when you log out of Slack
  • Never commit credentials to git

Tips

  1. Add a shell alias for convenience:

    alias slacker='uvx --from "git+https://github.com/shanemcd/slacker" slacker'

  2. Use JSON output for programmatic processing with jq

  3. Natural language reminders - Slack handles the parsing, just write naturally

  4. Check activity regularly - The activity command shows mentions you may have missed

  5. Use --since for DMs - Natural language date parsing makes it easy to filter

Links

  • Repository: https://github.com/shanemcd/slacker
  • Issues: https://github.com/shanemcd/slacker/issues

Last updated: 2026-01-15