# Discord TLDR Skill

Automatically summarize Discord server conversations and post digests to a dedicated #tldr channel.

## Overview

This skill configures scheduled summaries of your Discord server's activity. Perfect for:
- Teams who want async-friendly catch-up
- Servers with multiple active channels
- Anyone who doesn't want to scroll through hundreds of messages

## Requirements

- Clawdbot with Discord channel configured
- Bot must have read access to channels you want summarized
- A dedicated #tldr channel for posting summaries

## Setup

### 1. Create your #tldr channel

Create a text channel in your Discord server (e.g., `#tldr` or `#daily-digest`). Note the channel ID.

### 2. Get your Guild ID

Your Discord server's guild ID. You can get this by enabling Developer Mode in Discord, then right-clicking your server name.

### 3. Add the cron jobs

Run these commands in Clawdbot or add to your config:

```bash
# Morning summary (6 AM)
clawdbot cron add \
  --name "tldr-morning" \
  --schedule "0 6 * * *" \
  --tz "America/New_York" \
  --message "Read all recent messages from the Discord server (guild YOUR_GUILD_ID) across all channels since the last TLDR summary. Create a concise bullet-point summary of key discussions, decisions, ideas, and action items. Post the summary to the #tldr channel (channel id YOUR_TLDR_CHANNEL_ID)." \
  --to "channel:YOUR_TLDR_CHANNEL_ID" \
  --channel discord

# Afternoon summary (1 PM)
clawdbot cron add \
  --name "tldr-afternoon" \
  --schedule "0 13 * * *" \
  --tz "America/New_York" \
  --message "Read all recent messages from the Discord server (guild YOUR_GUILD_ID) across all channels since the last TLDR summary. Create a concise bullet-point summary of key discussions, decisions, ideas, and action items. Post the summary to the #tldr channel (channel id YOUR_TLDR_CHANNEL_ID)." \
  --to "channel:YOUR_TLDR_CHANNEL_ID" \
  --channel discord

# Night summary (10 PM)
clawdbot cron add \
  --name "tldr-night" \
  --schedule "0 22 * * *" \
  --tz "America/New_York" \
  --message "Read all recent messages from the Discord server (guild YOUR_GUILD_ID) across all channels since the last TLDR summary. Create a concise bullet-point summary of key discussions, decisions, ideas, and action items. Post the summary to the #tldr channel (channel id YOUR_TLDR_CHANNEL_ID)." \
  --to "channel:YOUR_TLDR_CHANNEL_ID" \
  --channel discord
```

### 4. Customize (optional)

**Change frequency:** Modify the cron expressions:
- `0 9 * * *` = 9 AM daily
- `0 */6 * * *` = every 6 hours
- `0 9 * * 1-5` = 9 AM weekdays only

**Change timezone:** Replace `America/New_York` with your timezone.

**Customize the prompt:** Edit the message to:
- Exclude certain channels
- Focus on specific topics
- Change summary format (bullets, paragraphs, etc.)
- Add action item extraction
- Tag specific roles for important updates

## Example Output

```
📋 **TLDR Summary** (Jan 25, 2026 - Morning)

**#general**
• Team discussed jacket-making skills and the legend of Nicholai's sibling
• Buba wrote an epic poem about said jacket (instant classic)

**#dev**
• Merged PR #42 for the new API endpoint
• Blocked on auth token refresh issue - @jake investigating

**#random**
• Heated debate about best pizza toppings (pineapple discourse continues)

**Action Items:**
- [ ] Jake: Fix token refresh bug
- [ ] Team: Review Q1 roadmap by Friday
```

## Troubleshooting

**Summaries not posting?**
- Check that Clawdbot has message read permissions in all channels
- Verify the tldr channel ID is correct
- Run `clawdbot cron list` to confirm jobs are enabled

**Summaries missing channels?**
- Bot needs explicit read access to private channels
- Some channels may be excluded by Discord permissions

## License

MIT - do whatever you want with it