community-status
npx machina-cli add skill lycfyi/community-agent-plugin/community-status --openclawCommunity Status
Show unified status across all configured community platforms (Discord, Telegram).
When to Use
- User says "what's my setup" or "show status"
- User says "check my community agents"
- User wants to see which platforms are configured
- User asks "what have I synced"
- Before troubleshooting to see current state
How to Execute
python ${CLAUDE_PLUGIN_ROOT}/tools/community_status.py
What It Shows
-
Platform Status
- Discord: configured/not configured, connected server
- Telegram: configured/not configured, connected group
-
Sync Info
- Last sync time
- Total messages synced
-
File Paths
- Config file location
- Profile file location
- Data directory
-
Setup State
- Whether setup is complete
- Setup mode used (quickstart/advanced)
Example Output
Community Agent Status
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Platforms:
✓ Discord: Connected (My Server)
✓ Telegram: Connected (My Group)
Sync:
Last sync: 2 hours ago
Messages: 1,234
Files:
Config: config/agents.yaml
Profile: config/PROFILE.md
Data: data/
Setup: Complete (quickstart mode)
Status Icons
- ✓ Fully configured and ready
- ○ Partially configured (needs init)
- ✗ Not configured
Bootstrap Trigger
IMPORTANT: Before showing status, check if persona is configured:
python ${CLAUDE_PLUGIN_ROOT}/tools/persona_status.py --json
If "configured": false, do not just show status. Instead, initiate the Bootstrap Ritual (see CLAUDE.md) to help the user set up their agent identity through a friendly conversation.
Only show the status output after persona setup is complete.
Next Steps
If platforms show issues:
- Run
discord-doctorortelegram-doctorto diagnose - Run
discord-initortelegram-initto configure
Source
git clone https://github.com/lycfyi/community-agent-plugin/blob/main/plugins/community-agent/skills/community-status/SKILL.mdView on GitHub Overview
Community Status provides a single view of all configured platforms (Discord, Telegram). It reports configuration, connection status, last sync time, and file locations, helping you understand your current setup and identify issues.
How This Skill Works
Runs a local script that aggregates each platform’s config, connection state, and sync data, then renders a structured status of Platforms, Sync, Files, and Setup. Before showing status, it checks persona configuration and may trigger the Bootstrap Ritual if setup is incomplete.
When to Use It
- User asks what's my setup or to show status
- User asks to check my community agents
- User wants to see which platforms are configured
- User asks what have I synced
- Before troubleshooting to see current state
Quick Start
- Step 1: Run python ${CLAUDE_PLUGIN_ROOT}/tools/community_status.py
- Step 2: Read the output sections: Platforms, Sync, Files, and Setup
- Step 3: If persona isn't configured, run python ${CLAUDE_PLUGIN_ROOT}/tools/persona_status.py --json and complete the Bootstrap Ritual
Best Practices
- Run the status command to get a unified view across platforms
- Verify each platform is configured and connected
- Check Sync Info for last sync time and total messages
- Inspect file paths to ensure correct config, profile, and data locations
- If persona is not configured, trigger the Bootstrap Ritual before proceeding
Example Use Cases
- Confirm Discord and Telegram connections and server/group
- Check last sync time and total messages synced to assess activity
- Verify file paths for config, profile, and data directories
- Review setup state and mode (quickstart/advanced) to plan next steps
- Diagnose issues by running discord-doctor or telegram-doctor
