What does discord-doctor do?

Diagnoses configuration and connectivity issues for Discord integration and reports failures with suggested fixes.

Does discord-doctor modify files?

No. It only diagnoses issues and provides manual steps to fix problems.

How do I run discord-doctor?

Run the command: python ${CLAUDE_PLUGIN_ROOT}/tools/discord_doctor.py and review the results.

discord-doctor

npx machina-cli add skill lycfyi/community-agent-plugin/discord-doctor --openclaw

Files (1)

SKILL.md

1.9 KB

Discord Doctor

Diagnose configuration and connectivity issues with Discord integration.

When to Use

User says "Discord not working" or "diagnose Discord"
User reports connection or authentication errors
User says "check Discord setup" or "troubleshoot Discord"
Before asking for help with Discord issues
When sync or other Discord commands fail unexpectedly

How to Execute

python ${CLAUDE_PLUGIN_ROOT}/tools/discord_doctor.py

What It Checks

Environment file - .env exists in cwd
Discord token - DISCORD_USER_TOKEN is set
Token format - Token appears valid (length, no prefixes)
Authentication - Token can connect to Discord API
Config file - config/agents.yaml exists and is valid YAML
Server configured - A default server is selected
Data directory - data/ is writable

Output

Displays results with:

✓ for passed checks
✗ for failed checks

For each failure, provides a suggested fix that the user can run manually.

Important: This tool only diagnoses issues - it does not modify any files.

Example Output

discord-doctor results:

  ✓ Environment file (.env found)
  ✓ Discord token (***...abc123)
  ✓ Token format (Format looks valid)
  ✗ Authentication (Token expired)
  ✓ Config file (Valid YAML)
  ✓ Server configured (My Server (1234))
  ✓ Data directory (./data)

Some checks failed. Suggested fixes:

  • Authentication:
    Your token may be expired. Get a fresh token from Discord DevTools.

(Run these steps manually - doctor does not modify files)

Next Steps

After fixing issues:

Run discord-init to reconfigure if needed
Run discord-sync to test connectivity

Source

git clone https://github.com/lycfyi/community-agent-plugin/blob/main/plugins/discord-user-connector/skills/discord-doctor/SKILL.md

View on GitHub

Overview

Discord Doctor diagnoses configuration and connectivity issues in Discord integration. It helps when users report problems with Discord sync, connection or authentication errors, or setup trouble.

How This Skill Works

The tool runs a scripted checklist via discord_doctor.py to verify environment files, token presence and validity, authentication to the Discord API, YAML config, server selection, and data directory writability. It then reports each check with a ✓ or ✗ and provides manual fixes for failures.

When to Use It

User says 'Discord not working' or 'diagnose Discord'
User reports connection or authentication errors
User says 'check Discord setup' or 'troubleshoot Discord'
Before asking for help with Discord issues
When sync or other Discord commands fail unexpectedly

Quick Start

Step 1: Run python ${CLAUDE_PLUGIN_ROOT}/tools/discord_doctor.py
Step 2: Read the doctor results for ✓/✗ checks and suggested fixes
Step 3: Apply fixes manually based on the suggestions (doctor does not modify files)

Best Practices

Run the doctor before deep troubleshooting to identify root causes
Ensure you have an Environment file (.env) in the current working directory
Verify DISCORD_USER_TOKEN is present and appears valid (correct length, no prefixes)
Confirm config/agents.yaml exists and is valid YAML, and that a default server is selected
Review the provided suggested fixes and apply them manually (the doctor does not modify files)

Example Use Cases

Environment file missing, .env not found
Discord token missing or invalid
Token format looks invalid
Authentication failed due to expired token
Config file invalid YAML or no default server selected

Frequently Asked Questions

Add this skill to your agents