home / skills / lycfyi / community-agent-plugin / community-status

community-status skill

safe

/plugins/community-agent/skills/community-status

This skill shows a unified status across configured community platforms, including setup, sync status, and file locations.

npx playbooks add skill lycfyi/community-agent-plugin --skill community-status

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

Files (2)

SKILL.md

2.1 KB

---
name: community-status
description: "Show unified status of all community platforms. Use when user wants to check their setup, see sync status, or get an overview."
---

# Community 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

```bash
python ${CLAUDE_PLUGIN_ROOT}/tools/community_status.py
```

## What It Shows

1. **Platform Status**
   - Discord: configured/not configured, connected server
   - Telegram: configured/not configured, connected group

2. **Sync Info**
   - Last sync time
   - Total messages synced

3. **File Paths**
   - Config file location
   - Profile file location
   - Data directory

4. **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:

```bash
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-doctor` or `telegram-doctor` to diagnose
- Run `discord-init` or `telegram-init` to configure

Overview

This skill shows a unified status of all configured community platforms (Discord, Telegram). It helps you verify setup, sync state, and file paths at a glance. Use it before troubleshooting or when you want a quick health check of your community agents.

How this skill works

The skill inspects platform configuration, connection state, and recent sync metadata for each configured channel. It reports last sync time, total messages synced, config/profile/data file locations, and overall setup mode. If the agent persona is not configured, it triggers the required bootstrap flow instead of exposing partial status.

When to use it

You ask “what's my setup” or “show status”.
You want to confirm which platforms are configured and connected.
You need last-sync time or message counts before troubleshooting.
You want to verify config, profile, and data file locations.
Before running diagnostics or re-initializing a platform.

Best practices

Always check persona configuration first; the skill will initiate bootstrap if persona is unconfigured.
Run this status check before running any doctor/init tools to get current context.
Keep config and profile paths backed up and note the data directory for audits.
Use the status output to decide next steps: doctor tools for issues, init for missing platforms.
Schedule periodic checks to monitor sync health and detect drops early.

Example use cases

Developer asks “show my community status” to confirm Discord and Telegram are connected.
Ops engineer reviews last sync and message counts before a release affecting bots.
Support agent confirms file paths and setup mode while guiding a user through troubleshooting.
User runs status to see whether to run discord-doctor or telegram-doctor next.
Administrator verifies persona is configured and, if not, completes bootstrap before continuing.

FAQ

What happens if the persona is not configured?

The skill will not show partial status; it initiates the persona bootstrap workflow and only shows status after setup completes.

Which fields are included in the status output?

Platform connectivity, last sync time, total messages synced, config/profile/data file locations, setup completion and mode (quickstart/advanced).