home / skills / lycfyi / community-agent-plugin / discord-read

discord-read skill

safe

/plugins/discord-user-connector/skills/discord-read

This skill reads and searches synced Discord messages, helping you view recent conversations and locate specific content quickly.

npx playbooks add skill lycfyi/community-agent-plugin --skill discord-read

Review the files below or copy the command above to add this skill to your agents.

Files (2)

SKILL.md

1.9 KB

---
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.

Overview

This skill reads and searches locally synced Discord messages to surface conversations, attachments, reactions, and replies. It helps you inspect channel history, find specific discussions by keyword or date, and export readable Markdown-formatted message views. Use it when you need quick visibility into Discord conversations without opening the app.

How this skill works

The tool scans a local sync of Discord data and renders messages in a consistent Markdown layout with date and message headers, reply indicators, attachments, embeds, and reactions. You can list all messages in a channel, limit to the last N messages, search by keyword, filter by date range, or target a specific server using identifiers. If no local sync exists for a channel, the tool reports missing data and recommends syncing first.

When to use it

You want to see recent or historical messages from a specific Discord channel.
You need to search conversations for keywords or phrases across a channel.
You need messages filtered by date range or limited to the last N entries.
You want a readable export of synced messages for review or archiving.
You need to inspect replies, attachments, embeds, or reaction summaries.

Best practices

Ensure messages are synced locally before running reads or searches.
Match channel names case-insensitively to synced channel names.
Use date range filters to narrow large histories and speed results.
Run a manifest check first to discover available server/channel data files.
Combine keyword search with server or date filters for precise results.

Example use cases

Show the last 20 messages from #general to catch up on a team discussion.
Search #dev for all messages mentioning "deploy" in the past week.
Export a channel's messages as Markdown for an audit or handoff.
Find the conversation where a specific decision was made using keyword search.
Check reactions and attachments for a message thread before a meeting.

FAQ

What if no messages are found for a channel?

The tool will suggest running the sync process first; confirm the channel was synced and check the manifest for available data paths.

Can I filter by server when channels have the same name?

Yes. Use the server identifier together with the channel name to target the correct synced data set.