GitHub

Motivation

OpenClaw (formerly Clawdbot, then Moltbot) has become hugely popular lately, and my favorite feature of it is being able to reach my agent through a Discord channel. I tried it myself, but you end up using the OpenClaw agent rather than Claude Code, and I didn’t want to give up Claude Code’s strengths: Hooks, Subagents, and Agent Teams.

In practice, I don’t need to run experiments through Discord. What I actually want is simpler: when I kick off an experiment on a server and step away, I want to hear about progress or results as soon as they come in. Now that Claude Code has become the center of my research workflow, the ideal is to just say “send the results to Discord when this experiment finishes” inside Claude Code.

So I built a Discord webhook notification skill for Claude Code.

Features

  • Text messages — Markdown support
  • Rich Embeds — Title, description, color, fields, timestamps
  • File attachments — Up to 10 files, 25MB each
  • Raw JSON — Full Discord webhook API access
  • Session Handoff — Hand off Claude Code CLI sessions to Discord bots
  • Custom bot name/avatar, thread support

Usage

Inside Claude Code

Just ask in natural language — the /sc:discord skill is invoked automatically:

"Send results to Discord"
"Share the training curve on Discord"
"Hand off this session to Discord"

Session Handoff posts a summary of the current session’s recent conversation to Discord and saves the session info to ~/.claude/last-handoff.json. Picking the session up from Discord requires a separate bot that reads this file.

Directly from the CLI

# Text
discord-notify "Hello world"

# Embed
discord-notify --embed "Experiment Done" "Accuracy: 87.3%" 5793266

# File attachment
discord-notify --file ./loss_curve.png "Training results"

# Multiple files
discord-notify --files loss.png acc.csv -- "All results"

# Pipe input
cat results.txt | discord-notify

Example: ML experiment results

discord-notify --name "Lab Bot" --rich '{
  "embeds": [{
    "title": "Experiment Complete",
    "color": 5793266,
    "fields": [
      {"name": "Model", "value": "ResNet-50", "inline": true},
      {"name": "Accuracy", "value": "87.3 ± 0.2%", "inline": true},
      {"name": "Baseline", "value": "85.1%", "inline": true}
    ],
    "footer": {"text": "seeds: 42,43,44 | p < 0.01"}
  }]
}'

Installation

git clone https://github.com/JunhyunB/claude-skill-discord.git
cd claude-skill-discord
./install.sh

Create a webhook URL in your Discord server settings and enter it during installation.