discord-read_skill

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.