Agent skill
pulse-weekly
Weekly community analysis report — aggregates Discord AND WhatsApp activity, engagement metrics, sentiment trends, top contributors, product insights, and docs gaps. Generates an HTML report using the Evolution brand. Use when user says 'weekly community', 'community analysis', 'weekly community report', or any reference to weekly community analysis.
Install this agent skill to your Project
npx add-skill https://github.com/EvolutionAPI/evo-nexus/tree/main/.claude/skills/pulse-weekly
SKILL.md
Weekly Community Report
Weekly routine that analyzes Discord and WhatsApp activity from the last 7 days and generates a complete HTML report.
Always respond in English.
Workflow
Step 1 — Collect the week's data
Use the /discord-get-messages skill to fetch messages from the last 7 days in the main channels.
Guild ID: YOUR_GUILD_ID
Channels to monitor:
- All community text channels (chat-pt, chat-en, chat-es, help, feedback, suggestions, showcase, news)
- New members channel (
🆕・new-members)
For each channel, fetch paginated messages (100 per request) to cover 7 days.
Step 1b — Collect WhatsApp data (7 days)
Use the /int-whatsapp skill to fetch messages and stats from the last 7 days:
python3 {project-root}/.claude/skills/int-whatsapp/scripts/whatsapp_client.py messages_7d
python3 {project-root}/.claude/skills/int-whatsapp/scripts/whatsapp_client.py stats --start $(date -u -v-7d '+%Y-%m-%d') --end $(date -u '+%Y-%m-%d')
python3 {project-root}/.claude/skills/int-whatsapp/scripts/whatsapp_client.py groups --start $(date -u -v-7d '+%Y-%m-%d') --end $(date -u '+%Y-%m-%d')
Include in the report as a separate "WhatsApp" section with: active groups, total messages, unique participants, topics, support questions.
Step 2 — Calculate metrics
- Growth: total members (estimate), new vs departed, net churn
- WAM (Weekly Active Members): unique members who sent a message
- Communicators: % of visitors who chat (goal: 50%)
- Resolution rate: answered questions / total in #help (goal: >80%)
- First response time: median time between question and first response
- Messages per active member: total msgs / WAM (goal: >4)
Step 3 — Analyze sentiment and topics
For each day of the week:
- Sentiment: classify messages as positive/neutral/negative
- Topics: group discussions by theme, count frequency
Consolidate:
- Top 5 topics with sentiment bar
- Sentiment trend throughout the week
Step 4 — Identify highlights
- Top 5 most active members: by message volume + answers given
- New members who contributed: who is new and already participated
- Members at risk of churn: previously active, inactive this week
Step 5 — Extract product insights
Analyze messages and identify:
- Most requested features: spontaneous feature requests
- Reported bugs: technical problems mentioned
- Docs gap: questions whose answers should be in the documentation (indicate frequency)
Step 6 — Comparison
If previous reports exist in workspace/community/reports/weekly/, compare:
- WAM this week vs previous
- New members vs previous
- Resolution rate vs previous
- Response time vs previous
Step 7 — Generate HTML report
Read the template at .claude/templates/html/custom/community-weekly-report.html.
Replace the placeholders {{...}} with the actual data.
Logo available at: workspace/projects/Evolution Foundation/Logos finais/Favicon logo/SVG/Favicon Color 500.svg
Save to:
workspace/community/reports/weekly/[C] YYYY-WXX-community-report.html
Step 8 — Executive summary
Present in the terminal:
## Weekly Report — Week {WXX}
Members: {N} ({+/-}) | WAM: {N} ({X}%)
Resolution: {X}% | 1st response: {X} min
Sentiment: {label}
Top: {topic 1}, {topic 2}, {topic 3}
Insights: {N} features, {N} bugs, {N} docs gaps
Report saved to workspace/community/reports/weekly/
Rules
- Do not reply to messages — only read and analyze
- Real data — metrics based on collected messages, no fabrication
- Docs gap is gold — each question without docs becomes a backlog item
- Comparison is fundamental — always show trend vs previous week
- Product insights — the most valuable section, handle with care
Notify via Telegram
Upon completion, send a short summary via Telegram to the user:
- Use the Telegram MCP:
reply(chat_id="YOUR_CHAT_ID", text="...") - Format: emoji + routine name + main result (1-3 lines)
- If the routine had no updates, send anyway with "no updates"
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
data-create-viz
Cria visualizações de dados de qualidade profissional com Python no tema Evolution (fundo escuro, acento
cs-customer-escalation
Empacota uma escalação para Devs, Produto ou Davidson com contexto completo. Use quando um bug precisa de atenção além do suporte normal, vários clientes reportam o mesmo problema, um cliente está ameaçando cancelar, ou um problema ficou sem resolução além do SLA. / Package an escalation for engineering, product, or leadership with full context. Use when a bug needs engineering attention beyond normal support, multiple customers report the same issue, a customer is threatening to churn, or an issue has sat unresolved past its SLA.
mkt-draft-content
Draft blog posts, social media, email newsletters, landing pages, press releases, and case studies with channel-specific formatting and SEO recommendations. Use when writing any marketing content, when you need headline or subject line options, or when adapting a message for a specific platform, audience, and brand voice.
gog-tasks
Create, manage, and prioritize tasks and todo items. Convert emails to tasks, set priorities (P0-P3) and categories (Work/Personal/Errands/Admin), review daily priorities, track blocked and overdue tasks. Use when user mentions tasks, todos, action items, or wants to convert emails to tasks. Requires confirmation before creating or deleting tasks.
discord-get-messages
Retrieve messages from Discord channels via the Discord API. Use this skill when the user wants to read, search, or analyze messages from a Discord channel.
cs-customer-research
Pesquisa multi-fonte sobre pergunta ou tópico de cliente com atribuição de fontes. Use quando um cliente pergunta algo que precisa ser verificado, investigando se um bug foi reportado antes, verificando o que foi dito anteriormente a uma conta específica, ou coletando contexto antes de redigir uma resposta. / Multi-source research on a customer question or topic with source attribution. Use when a customer asks something you need to look up, investigating whether a bug has been reported before, checking what was previously told to a specific account, or gathering background before drafting a response.
Didn't find tool you were looking for?