jhillock

Discord Doctor

IT Ops & Securityv1.0.0
By jhillockUpdated 2026-05-11discord-doctor@clawhub_jhillock/discord-doctor
Security ScanningTroubleshooting#Discord

According to AlphaMoat, as of 2026-09, Discord Doctor has 3,255 downloads and 1 stars — ranked #3,505 of 5,078 AI skills overall, and #226 of 264 in IT Ops & Security.

Installs
103
Downloads
3.3K
Stars
1
Overall Rank
#3,505
Top 70% overall · Top 86% in IT Ops & Security
PlatformInstallsDownloadsStarsComments
ClawHub ↗1033.1K1-
SkillHub ↗1033.3K1—

Platforms count differently and update at different times.

What this skill does

It describes checking app and service status, connectivity, token validity, and recent activity. Its --fix mode may also install dependencies, start or restart services, remove a legacy launchd entry, or move a configuration directory. These repairs can change system state or affect service availability; review the exact commands, target paths, reversibility, and authorization before execution.

Profile published 2026-10-29

What you can do with it

  • Summarize checks for Discord bot, Gateway, and OAuth status.
  • Distinguish read-only diagnostics from automatic repairs that may change the system.
  • Review paths and side effects involved in legacy-configuration migration.

When to use it

  • When investigating Discord connectivity or Gateway availability.
  • When checking for an expired OAuth token or a legacy-configuration conflict.
  • Before running an automatic repair, when the items to install, restart, remove, or move need review.

Example prompts

Generated from the skill’s documentation as examples; not results of actual runs.

Use this guide to outline diagnostic steps without running an automatic repair.
Explain each system component and configuration path this repair mode may change.

Monthly Trend

Downloads3.3K
2.1K2.7K3.3K2026-03 · Downloads 2.1K2026-05 · Downloads 2.6K2026-07 · Downloads 2.9K2026-08 · Downloads 3.1K2026-09 · Downloads 3.3K26-0326-09
Stars1
0122026-03 · Stars 12026-05 · Stars 12026-07 · Stars 12026-08 · Stars 12026-09 · Stars 126-0326-09

The counting method changed in 2026-09: skills with the same name are now counted separately by author, and the full catalog is covered. Dashed lines show months before the change; they are not compared with later months, and no growth is computed across the change.

MonthDownloadsMoMStars
2026-093.3K—1
2026-083.1K+4.1%1
2026-072.9K—1
2026-052.6K—1
2026-032.1K—1

SKILL.md (original)

The author’s original file, shown as plain text without edits or review by AlphaMoat. Links are not clickable; check commands before running them. Fetched 2026-10-23.

2.9 KB · ClawHub v1.0.0
---
name: discord-doctor
description: Quick diagnosis and repair for Discord bot, Gateway, OAuth token, and legacy config issues. Checks connectivity, token expiration, and cleans up old Clawdis artifacts.
metadata: {"clawdbot":{"emoji":"🩺","os":["darwin","linux"],"requires":{"bins":["node","curl"]}}}
---

# Discord Doctor

Quick diagnosis and repair for Discord/Gateway availability issues, OAuth token problems, and legacy Clawdis configuration conflicts.
Show all (100 lines)
## Usage

```bash
# Check status (diagnostic only)
discord-doctor

# Check and auto-fix issues
discord-doctor --fix
```

## What It Checks

1. **Discord App** - Is the Discord desktop app running (optional, for monitoring)
2. **Gateway Process** - Is the Clawdbot gateway daemon running
3. **Gateway HTTP** - Is the gateway responding on port 18789
4. **Discord Connection** - Is the bot actually connected to Discord (via `clawdbot health`)
5. **Anthropic OAuth** - Is your OAuth token valid or expired
6. **Legacy Clawdis** - Detects old launchd services and config directories that cause conflicts
7. **Recent Activity** - Shows recent Discord sessions

## Auto-Fix Capabilities

When run with `--fix`, it can:

- **Start gateway** if not running
- **Install missing npm packages** (like discord.js, strip-ansi)
- **Restart gateway** after fixing dependencies
- **Remove legacy launchd service** (`com.clawdis.gateway.plist`)
- **Backup legacy config** (moves `~/.clawdis` to `~/.clawdis-backup`)

## Common Issues & Fixes

| Issue | Auto-Fix Action |
|-------|-----------------|
| Gateway not running | Starts gateway on port 18789 |
| Missing npm packages | Runs `npm install` + installs specific package |
| Discord disconnected | Restarts gateway to reconnect |
| OAuth token expired | Shows instructions to re-authenticate |
| Legacy launchd service | Removes old `com.clawdis.gateway.plist` |
| Legacy ~/.clawdis config | Moves to `~/.clawdis-backup` |

## OAuth Token Issues

If you see "Access token EXPIRED", run:
```bash
cd ~/Clawdis && npx clawdbot configure
```
Then select "Anthropic OAuth (Claude Pro/Max)" to re-authenticate.

## Legacy Clawdis Migration

If you upgraded from Clawdis to Clawdbot, you may have legacy artifacts causing OAuth token conflicts:

- **Old launchd service**: `~/Library/LaunchAgents/com.clawdis.gateway.plist`
- **Old config directory**: `~/.clawdis/`

Run `discord-doctor --fix` to clean these up automatically.

## Example Output

```
Discord Doctor
Checking Discord and Gateway health...

1. Discord App
   Running (6 processes)

2. Gateway Process
   Running (PID: 66156, uptime: 07:45)

3. Gateway HTTP
   Responding on port 18789

4. Discord Connection
   Discord: ok (@Clawdis) (321ms)

5. Anthropic OAuth
   Valid (expires in 0h 45m)

6. Legacy Clawdis
   No legacy launchd service
   No legacy config directory

7. Recent Discord Activity
   - discord:group:123456789012345678 (21h ago)

Summary
All checks passed! Discord is healthy.
```

Popular in IT Ops & Security

Data month: 2026-09 · Downloads, stars and installs are aggregated monthly from public skill registries (ClawHub, SkillHub). See methodology.