AgentSkillsCN

discord-read

阅读并搜索同步的 Discord 消息。当用户希望了解 Discord 对话、查看特定消息，或查找特定内容时，这一技能将助您事半功倍。

SKILL.md
--- frontmatter
name: discord-read
description: "Read and search synced Discord messages. Use when user asks about discord conversations, wants to see messages, or search for specific content."

Discord Read

Read locally synced Discord messages and search for specific content.

When to Use

  • •User asks "what's in #channel"
  • •User asks about recent Discord conversations
  • •User wants to search Discord messages
  • •User asks "show me messages from Discord"
  • •User wants to find specific Discord discussion

How to Execute

Read all messages from a channel:

bash
python ${CLAUDE_PLUGIN_ROOT}/tools/discord_read.py --channel CHANNEL_NAME

Read last N messages:

bash
python ${CLAUDE_PLUGIN_ROOT}/tools/discord_read.py --channel general --last 20

Search for keyword:

bash
python ${CLAUDE_PLUGIN_ROOT}/tools/discord_read.py --channel general --search "project update"

Filter by date range:

bash
python ${CLAUDE_PLUGIN_ROOT}/tools/discord_read.py --channel general --from 2026-01-01 --to 2026-01-03

Read from specific server:

bash
python ${CLAUDE_PLUGIN_ROOT}/tools/discord_read.py --channel general --server SERVER_ID

Alternative: Direct File Read

For simpler access, first check what data exists using the manifest:

bash
python ${CLAUDE_PLUGIN_ROOT}/tools/discord_manifest.py

Then read the markdown file directly (paths from manifest are relative to cwd):

bash
cat ./data/{server_id}/{channel_name}/messages.md

Output Format

Messages are formatted in Markdown with:

  • •Date headers (## YYYY-MM-DD)
  • •Message headers (### Time - @author)
  • •Reply indicators (↳ replying to @user)
  • •Attachments and embeds
  • •Reactions

Prerequisites

  • •Messages must be synced first using discord-sync skill
  • •Channel name must match synced channel (case-insensitive)

Error Handling

If messages are not found, the tool suggests running sync first.