Agent skill

slack

Manage unread Slack messages across the workspace: list, open, and reply with confirmation. Stores metadata for later actions.

View SKILL.md on GitHub Repository
Stars 32
Forks 3

Install this agent skill to your Project

npx add-skill https://github.com/antoniolg/agent-kit/tree/main/skills/slack

SKILL.md

Slack (inbox + reply)

Requirements

  • Environment variable: SLACK_USER_TOKEN (user token).
  • Recommended scopes: channels:read, groups:read, im:read, mpim:read, channels:history, groups:history, im:history, mpim:history, users:read, chat:write.
  • To mark as read (granular scopes): channels:write, groups:write, im:write, mpim:write (depends on conversation type).

Commands (from the skill folder)

1) Inbox (unread)

scripts/slack-inbox --json-out /tmp/slack-inbox.json
  • Shows a clean numbered list.
  • Saves metadata for later actions.

2) Open a message

scripts/slack-open --index <n>
  • Uses /tmp/slack-inbox.json to resolve IDs.
  • Writes /tmp/slack-open.json.

3) Reply (with user confirmation)

scripts/slack-reply --index <n> --text "reply"
  • In channels: replies in thread if it exists (default).
  • In DMs: use --no-thread to reply as a new message.
  • After replying, mark as read with scripts/slack-mark-read --index <n>.

4) Mark as read

scripts/slack-mark-read --index <n>

Metadata format

/tmp/slack-inbox.json contains:

  • index
  • id (channel id)
  • name
  • type
  • last_read
  • latest_ts
  • latest_text
  • latest_user_id
  • latest_user_name
  • unread_count
  • unread_has_more

Rules

  • Show the user only the clean list; do not show IDs.
  • Before replying, ask for confirmation.
  • If the JSON is stale or missing, re-run inbox.
  • In DMs, always reply with --no-thread and then mark as read.
  • After replying (channels or DMs), mark as read to clear pending items.

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

antoniolg/agent-kit

gen-pdf

Converts a Markdown file to a styled PDF with DevExpert branding (logo in bottom-right corner). Use when asked to generate a PDF from a Markdown document, or when any DevExpert proposal/document needs to be exported as PDF.

32 3
Explore
antoniolg/agent-kit

cloudflared-tunnel

Create temporary public URLs for localhost apps using Cloudflare Quick Tunnels with tmux-based process management. Use when you need to preview a local app externally (mobile device, remote collaborator, QA), including host-allowlist fixes when a dev server blocks external hosts.

32 3
Explore
antoniolg/agent-kit

email

Manage inbox email. Uses the inbox script and stores metadata (ids) to open or archive messages later.

32 3
Explore
antoniolg/agent-kit

whatsapp-evo

Manage WhatsApp via Evolution API (v2.x): list chats with unread messages and reply.

32 3
Explore
antoniolg/agent-kit

create-cli

Design command-line interface parameters and UX: arguments, flags, subcommands, help text, output formats, error messages, exit codes, prompts, config/env precedence, and safe/dry-run behavior. Use when you’re designing a CLI spec (before implementation) or refactoring an existing CLI’s surface area for consistency, composability, and discoverability.

32 3
Explore
antoniolg/agent-kit

academy-enrollments

Manage academy enrollments by appending rows to a Google Sheet (used by Zapier/n8n to grant LearnWorlds access).

32 3
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results