| name | discord-chat-summary |
| description | Summarize Discord chat messages across servers. Use when user asks for chat summary, digest, highlights, recap, or overview of Discord conversations. |
Discord Chat Summary
Generate summaries of synced Discord chat messages. Claude reads the message files directly and produces a concise summary of key discussions, topics, and activity.
When to Use
- User asks for a summary of Discord chats
- User wants a digest or recap of Discord conversations
- User asks "what's been happening" in Discord
- User wants highlights from Discord channels
- User asks for an overview of Discord activity
- User wants to catch up on Discord messages
How to Execute
Step 1: Get the Manifest
First, get the manifest to understand what data is available. Use the manifest tool which auto-creates the data directory and manifest if they don't exist:
python ${CLAUDE_PLUGIN_ROOT}/tools/discord_manifest.py
This shows all synced servers, channels, message counts, and last sync times.
If no data exists, the tool will guide the user to sync first.
CRITICAL PATH RESOLUTION: All data paths shown in the manifest are relative to the current working directory (cwd) where Claude is running - NOT relative to this skill file or the plugin directory.
Step 2: Determine Scope
Ask user or infer from their request which scope to summarize:
| Scope | Description |
|---|
| All servers | Summarize across all synced servers |
| Specific server | Summarize all channels in one server |
| Specific channel | Summarize a single channel |
Step 3: Read Messages
Read the relevant messages.md files based on scope:
For all servers:
Read each: ./data/{server-dir}/{channel}/messages.md
For specific server (e.g., "Midjourney"):
Read: ./data/662267976984297473-midjourney/*/messages.md
For specific channel:
Read: ./data/{server-dir}/{channel-name}/messages.md
Step 4: Apply Time Filtering (Optional)
If user specifies a time range, filter messages by date headers in the markdown:
| User Request | Filter Logic |
|---|
| "last 7 days" | Only include messages under ## YYYY-MM-DD headers from the past 7 days |
| "this week" | Messages from current week (Monday-Sunday) |
| "since Jan 1" | Messages from ## 2026-01-01 onwards |
| "yesterday" | Messages from yesterday's date only |
Date headers in messages.md look like: ## 2026-01-03
Step 5: Generate Summary
Produce a summary including:
- Key topics: Main subjects discussed
- Active participants: Most active users (by message count)
- Notable discussions: Important conversations or decisions
- Questions asked: Unanswered questions if relevant
- Sentiment: Overall tone (helpful, heated, casual, etc.)
Example Usage
User: "Summarize the Discord chats from last week"
Claude:
- Runs
python ${CLAUDE_PLUGIN_ROOT}/tools/discord_manifest.py to list available servers
- Reads all
messages.md files from paths in manifest
- Filters to only include
## 2025-12-27 through ## 2026-01-03
- Generates summary
User: "What's been happening in the Midjourney server?"
Claude:
- Runs
python ${CLAUDE_PLUGIN_ROOT}/tools/discord_manifest.py
- Finds Midjourney server directory from manifest
- Reads all channel messages.md files in that server
- Generates server-wide summary
User: "Give me a quick digest of #general"
Claude:
- Runs
python ${CLAUDE_PLUGIN_ROOT}/tools/discord_manifest.py to find #general channel path
- Reads that specific
messages.md
- Generates channel-focused summary
Message Format Reference
Messages in messages.md are structured as:
## 2026-01-03
### 4:12 AM - @username (user_id)
Message content here
### 4:30 AM - @another_user (user_id)
↳ replying to @username:
Reply content
Reactions: heart 2 | rocket 1
Prerequisites
- Messages must be synced first using the
discord-sync skill
- At least one server/channel should have data in
./data/ directory (relative to cwd)
Limitations
- Only summarizes locally synced messages (not live Discord data)
- Cannot summarize messages not yet pulled via
discord-sync
- Large message volumes may require focusing on specific channels or date ranges
Next Steps
- Use
discord-sync to pull fresh messages before summarizing
- Use
discord-read to view full message details after identifying interesting discussions
