agent-discord_skill

This skill helps you manage Discord servers with AI agents by automating messages, channel queries, and server state retrieval.

TypeScript

14

GitHub Stars

1

Bundled Files

2 months ago

Catalog Refreshed

4 months ago

First Indexed

Readme & install

Copy the install command, review bundled files from the catalogue, and read any extended description pulled from the listing source.

Installation

Preview and clipboard use veilstrat where the catalogue uses aiagentskills.

npx veilstrat add skill devxoul/agent-messenger --skill agent-discord

SKILL.md7.3 KB

Overview

This skill lets AI agents and operators interact with Discord servers via a TypeScript CLI. It supports sending and reading messages, managing reactions, creating threads, DMs, and taking full server snapshots. Authentication uses seamless token extraction from the Discord desktop app and outputs JSON by default for easy AI consumption.

How this skill works

The CLI extracts a user token from the local Discord desktop app, validates it against the Discord API, and stores credentials securely. Once authenticated, commands operate on servers, channels, messages, users, reactions, threads, files, and snapshots. All command output is JSON by default, with an optional --pretty flag for human-readable formatting.

When to use it

Automate sending or reading messages in text channels from an agent
Capture a full server snapshot for offline analysis or model context
Manage reactions or thread lifecycle programmatically
Query channel, user, or message metadata for tooling or audits
Create or list DM channels to programmatically converse with users

Best practices

Run auth extract on the same machine with the Discord desktop app installed to avoid manual token handling
Use channel list and server list to resolve snowflake IDs before issuing commands
Prefer snapshot --limit to reduce payload size for large servers
Handle standardized error JSON responses programmatically for robust automation
Keep credentials file permissions restricted (0600) and rotate tokens if security changes occur

Example use cases

Send status updates to a specific channel: message send <channel-id> "Deployment complete"
Monitor a channel and forward recent messages into an agent pipeline using message list or snapshot
React to messages programmatically when an automated check passes or fails using reaction add/remove
Create a private DM to escalate a conversation: dm create <user-id> then message send to the DM channel
Produce a server summary for an agent by running snapshot --channels-only or --users-only

FAQ

No. This tool uses user tokens extracted from the desktop app; bot tokens are not supported in v1.

Does this provide real-time events via Gateway?

No. It does not open a real-time Gateway connection; use snapshot and polling commands for state updates.

Can I use channel names instead of IDs?

No. Discord uses snowflake IDs for channels and messages. Use channel list to obtain IDs.