home / skills / lycfyi / community-agent-plugin / discord-members

discord-members skill

safe

/plugins/discord-user-connector/skills/discord-members

This skill queries existing synced Discord member data, fetches rich profiles, tracks churn, and exports insights to help you manage communities.

npx playbooks add skill lycfyi/community-agent-plugin --skill discord-members

Review the files below or copy the command above to add this skill to your agents.

Files (1)

SKILL.md

2.7 KB

---
name: discord-members
description: "Query existing member data, track churned members, fetch rich profiles (bio, pronouns). NOT for syncing - use discord-bot-connector:discord-bot-members to sync members."
---

# Discord Members

Member queries, churn tracking, profile management, and exports.

## ⚠️ CRITICAL: For Syncing Members

**DO NOT use this skill for syncing members.** User tokens can only see 2-10 cached members.

**For member syncing, ALWAYS use the `discord-bot-connector` plugin:**
```
Skill(skill: "discord-bot-connector:discord-bot-members")
```

If the user asks to "sync members", invoke the discord-bot skill, NOT this one.

## When to Use THIS Skill

Use this skill ONLY for:
- Querying **already synced** member data
- Rich profile fetching (bio, pronouns, connected accounts)
- Churn tracking (who left)
- Silent member detection
- Member search and export

## When to Use discord-bot Skill Instead

Use `discord-bot-connector:discord-bot-members` when:
- User asks to "sync members"
- User asks for "member list" or "get all members"
- User asks "how many members"
- Any operation that needs the complete member list

## How to Execute

**All commands below work with EXISTING synced data. To sync fresh data, use discord-bot plugin first.**

### Query existing member data:

```bash
python ${CLAUDE_PLUGIN_ROOT}/tools/member_query.py new --server SERVER_ID --since 7d
```

### List churned members:

```bash
python ${CLAUDE_PLUGIN_ROOT}/tools/churn_tracker.py --server SERVER_ID
```

### List silent members (never posted):

```bash
python ${CLAUDE_PLUGIN_ROOT}/tools/member_query.py silent --server SERVER_ID
```

### Engagement breakdown:

```bash
python ${CLAUDE_PLUGIN_ROOT}/tools/member_query.py engagement --server SERVER_ID
```

### Search members by description:

```bash
python ${CLAUDE_PLUGIN_ROOT}/tools/member_query.py find "developers" --server SERVER_ID
```

### View member profile (with rich data):

```bash
python ${CLAUDE_PLUGIN_ROOT}/tools/profile_fetcher.py --user USER_ID --server SERVER_ID
```

### Fetch rich profiles (batch):

```bash
python ${CLAUDE_PLUGIN_ROOT}/tools/profile_fetcher.py --server SERVER_ID --sample 50
```

### Export to CSV/JSON/Markdown:

```bash
python ${CLAUDE_PLUGIN_ROOT}/tools/member_export.py --server SERVER_ID --format csv
```

## Output Location

All paths are relative to cwd:

```
data/discord/{server_id}_{slug}/members/current.yaml
data/discord/{server_id}_{slug}/members/churned/
profiles/discord/{user_id}_{slug}.yaml
reports/discord/exports/members_{timestamp}.csv
```

## Prerequisites

- `.env` with `DISCORD_USER_TOKEN` set
- Python 3.11+ installed
- **For syncing members: Use `discord-bot-connector` plugin with `DISCORD_BOT_TOKEN`**

Overview

This skill lets you query and analyze existing Discord member data, track churn, and fetch rich member profiles (bio, pronouns, connected accounts). It works only with already-synced data and is designed for exploration, reporting, and targeted exports rather than full synchronization. Use it to inspect membership details, find silent users, and generate CSV/JSON/Markdown exports for analysis.

How this skill works

The skill reads cached member datasets and profile YAML files produced by a separate sync process. It provides CLI tools to run queries (new members, silent members, engagement breakdowns), churn tracking, profile fetches, and batch profile sampling. Outputs are written to standardized data and report folders for downstream use.

When to use it

Query already-synced member data (new, silent, engagement)
Fetch rich profiles for individual users or small batches
Track churned members who left the server
Search members by bio, pronouns, or description text
Export selected member subsets to CSV/JSON/Markdown

Best practices

Do not use this skill to attempt a full member sync — cached user tokens only expose a limited subset. Use a bot-based sync plugin for complete lists.
Run a fresh sync with a bot connector before large analyses that require full membership coverage.
Limit profile batch fetches to reasonable sample sizes to avoid rate limits and long runtimes.
Store and version exported reports in your analytics workspace for reproducibility.
Use engagement and churn outputs to drive targeted outreach or retention experiments, not as absolute ground truth.

Example use cases

Generate a CSV of recently active members for onboarding outreach.
List churned members from the past 30 days to analyze retention issues.
Fetch rich profiles (bio, pronouns, connected accounts) for a conference speaker list.
Identify silent members who never posted to invite to engagement campaigns.
Produce an engagement breakdown report for community health dashboards.

FAQ

Can I use this to sync the entire server member list?

No. This skill only queries already-synced data. For full member syncs, use a bot-based connector designed for syncing members.

Where are outputs saved?

Exports and data are written to standardized folders (data/discord/... for members, profiles/discord/... for profile YAMLs, reports/discord/exports/ for CSV/JSON/Markdown reports).