Persona Context
REQUIRED: Before executing this skill, load your configured persona:
bash
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
bash
# 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
- •Sync first: Run
/discord-syncto get latest messages - •More data = better trends: Use
--days 90for trend analysis - •Regular monitoring: Run weekly to track community health
- •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