Discord Chat Summary

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.

Persona Context

REQUIRED: Before executing this skill, load your configured persona:

python ${CLAUDE_PLUGIN_ROOT}/../community-agent/tools/persona_status.py --prompt

This outputs your persona definition. Apply it when generating summaries:

• Voice: Present findings in the persona's voice ("I noticed...", "I recommend...")
• Style: Use the persona's preferred formatting (bullet points vs prose)
• Framing: Frame insights and recommendations as the persona would
• Tone: Match the persona's warmth/formality in the summary introduction

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

Smart Defaults (Reduce Questions)

When user is vague, apply these defaults instead of asking:

When NO data exists:

1. Don't just say "no data found"
2. Run /discord-quickstart flow instead
3. Offer to sync recommended servers, then summarize

Only ask for clarification when:

• Multiple interpretations are equally valid
• User explicitly asks "which servers do I have?"

How to Execute

Step 0: Handle Empty State

First check if any data exists:

python ${CLAUDE_PLUGIN_ROOT}/tools/discord_status.py --json

If sync.has_data is false:

• DON'T just say "no data, run sync first"
• Instead, run the /discord-quickstart flow to help them sync
• Then proceed to summarize

Step 1: Get the Manifest

Get the manifest to understand what data is available:

python ${CLAUDE_PLUGIN_ROOT}/tools/discord_manifest.py

This shows all synced servers, channels, message counts, and last sync times.

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: Display Data Coverage (REQUIRED)

Before generating any summary, ALWAYS show the date coverage to the user.

Extract and display this information from the manifest:

Data Coverage:
- Server: [ServerName] - [first_message] to [last_message] ([days_covered] days)
  - #channel1: [message_count] messages
  - #channel2: [message_count] messages

Get this from manifest fields:

• servers[].date_range.first_message - oldest message date
• servers[].date_range.last_message - newest message date
• servers[].date_range.days_covered - total days of data
• servers[].channels[].message_count - messages per channel

This step is NOT optional. Users must see what date range they're getting before the summary.

Step 3: Determine Scope

Ask user or infer from their request which scope to summarize:

Step 4: 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 5: Apply Time Filtering

If user specifies a time range, filter messages by date headers in the markdown.

IMPORTANT: When filtering, tell the user what filter you applied:

Date headers in messages.md look like: ## 2026-01-03

Example filter output: "Filtering to last 7 days (Jan 3-10, 2026)"

Step 6: Generate Summary (REQUIRED FORMAT)

All summaries MUST include a date range header. Never produce a summary without showing the period covered.

Required Summary Format:

## [Server Name] Summary
**Period:** [start_date] to [end_date] ([N] days)
**Messages:** [count] | **Channels:** [count] | **Active Users:** [count]

---

### Key Topics
| Date | Topic | Channel |
|------|-------|---------|
| Jan 9 | [Topic description] | #channel |
| Jan 8 | [Topic description] | #channel |

### Notable Discussions
- **[Topic]** (Jan 9, #channel): [Brief description of the discussion]
- **[Topic]** (Jan 8, #channel): [Brief description]

### Active Participants
@user1 (45 msgs), @user2 (32 msgs), @user3 (28 msgs)

### Unanswered Questions
- "[Question text]?" (@user, Jan 8, #channel)

Key requirements:

• Period/date range MUST be in the header
• Topics should include the date they were discussed
• Include channel context for multi-channel summaries

Example Usage

User: "Summarize the Discord chats from last week"

Claude:

1. Runs python ${CLAUDE_PLUGIN_ROOT}/tools/discord_manifest.py to list available servers
2. Reads all messages.md files from paths in manifest
3. Filters to only include ## 2025-12-27 through ## 2026-01-03
4. Generates summary

User: "What's been happening in the Midjourney server?"

Claude:

1. Runs python ${CLAUDE_PLUGIN_ROOT}/tools/discord_manifest.py
2. Finds Midjourney server directory from manifest
3. Reads all channel messages.md files in that server
4. Generates server-wide summary

User: "Give me a quick digest of #general"

Claude:

1. Runs python ${CLAUDE_PLUGIN_ROOT}/tools/discord_manifest.py to find #general channel path
2. Reads that specific messages.md
3. 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