discord-analyze

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 presenting health reports:

• Voice: Introduce findings as the persona ("I've analyzed your community...")
• Recommendations: Present suggestions in the persona's communication style
• Tone: Use the persona's warmth when highlighting concerns or celebrations
• Framing: Frame metrics and insights as the persona would explain them

Description

Analyze synced Discord data to generate a comprehensive community health report. Includes:

• Activity metrics (message volume, channel breakdown, peak times)
• Engagement metrics (reply rate, response time, reactions)
• Contributor analysis (top contributors, diversity)
• Topic clustering (automatic grouping of conversations by theme)
• Trend detection (week-over-week changes)
• Benchmark comparison (healthy/warning/critical thresholds)
• Actionable recommendations

Prerequisites

• Discord data must be synced first (use /discord-sync)
• Minimum 7 days of message history recommended (30 days for trends)

Usage Examples

# Analyze your default server
/discord-analyze

# Analyze specific server with 30 days of history
/discord-analyze --server 1196028153085296651 --days 30

# Compare two communities
/discord-analyze --server 1196028153085296651 --compare 1347066703158181888

# Show detailed progress
/discord-analyze --verbose

# Output in different formats
/discord-analyze --format yaml
/discord-analyze --format json

Trigger Phrases

• "analyze Discord"
• "community health"
• "health report"
• "how is my community doing"
• "Discord metrics"
• "analyze community"
• "community analytics"

Output

Creates two files in the server's data directory:

• health-report.md - Human-readable markdown report
• health-report.yaml - Structured data for automation

Returns a summary with:

• Overall health score (0-100)
• Key metrics summary
• Top findings and recommendations

Arguments

Argument	Description
--server ID	Server ID to analyze (defaults to config)
--days N	Days of history to analyze (default: 30)
--compare ID	Server ID for comparison
--format	Output format: markdown, yaml, json
--verbose	Show detailed progress
--output PATH	Custom output path

Exit Codes

Code	Meaning
0	Success
1	Configuration error
2	Data error (no synced data)
3	Analysis error

Tips

1. Sync first: Run /discord-sync to get latest messages
2. More data = better trends: Use --days 90 for trend analysis
3. Regular monitoring: Run weekly to track community health
4. Act on recommendations: Each report includes prioritized actions

Related Skills

• /discord-sync - Sync messages before analysis
• /discord-list - List available servers and channels
• /discord-read - Read specific channel messages