discord-doctor

Validate Discord environment, tokens, and connectivity to diagnose integration issues.

5|1|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/lycfyi/community-agent-plugin --skill discord-doctor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: discord-doctor
Source: https://github.com/lycfyi/community-agent-plugin/tree/main/plugins/discord-user-connector/skills/discord-doctor
Command: npx skills add https://github.com/lycfyi/community-agent-plugin --skill discord-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams quickly diagnose and troubleshoot issues with Discord integration by validating environment setup, tokens, and connectivity.

Core Features & Use Cases

  • Environment and token validation to ensure proper authentication and access to Discord API
  • Connectivity and configuration checks to identify misconfigurations or missing server setup
  • Guided, deterministic steps for manual fixes and next steps when issues are detected

Quick Start

Run the diagnostic tool to detect common problems and generate a repair plan:

  • python ${CLAUDE_PLUGIN_ROOT}/tools/discord_doctor.py

Frequently Asked Questions about discord-doctor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I troubleshoot Discord authentication errors and sync failures?

To troubleshoot Discord authentication errors, run a diagnostic tool that validates environment setup, checks DISCORD_USER_TOKEN validity, verifies config/agents.yaml integrity, and tests server connectivity to return a clear results summary.

Why does my Discord API integration keep failing to connect?

Discord API integration failures often stem from missing .env files, invalid DISCORD_USER_TOKEN values, or unwritable data directories; running deterministic checks on these variables identifies the exact misconfiguration causing the connection failure.

What does a Discord diagnostic tool check when validating environment setup?

A Discord diagnostic tool checks for .env file presence, validates DISCORD_USER_TOKEN format and authentication, verifies config/agents.yaml integrity, confirms server selection, and ensures the data directory is writable to detect integration issues.

Can I use this diagnostic tool to fix misconfigurations across user accounts and servers?

Yes, you can use this diagnostic tool to detect misconfigurations across user accounts and servers by enforcing deterministic checks on environment variables, tokens, and server selection, providing guided manual fix steps when issues are detected.

Do I need a specific configuration file format to diagnose Discord integration issues?

Yes, you need a config/agents.yaml file for diagnosing Discord integration issues, as the diagnostic process enforces checks on its integrity alongside .env presence and DISCORD_USER_TOKEN validity to ensure proper environment setup.