AI agent skill · by @TryCaspian

Caspian Connect Discord

Connect Caspian Discord for OpenCode (install OAuth or BYO bot token), enable discord in caspian.json channels, and tell the user to restart. Use when linking Discord or running /caspian:connect-discord.

Archived 2026-10-23 · Source updated 2026-08-25 · License: Apache-2.0. Check the original repository for the latest version.

SKILL.md instructions

# Caspian connect Discord

Connect Discord to Caspian and enable `discord` in the plugin admit list
(`channels` in `~/.config/opencode/caspian.json`). Without `discord` in
`channels`, Discord events are rejected at admit (blast-radius wall).

Connect is **non-CP** (failures must not kill the email/telegram listen loop).
Admit reload requires **restart OpenCode**.

## When to use

- User asks to connect Discord
- User runs `/caspian:connect-discord` or `/caspian-connect-discord`

## How

1. Call **`caspian_connections`**.
2. Call **`caspian_connect_discord`**.
   - Default: one-click `installDiscord()` if no `DISCORD_BOT_TOKEN`
   - Or BYO: `DISCORD_BOT_TOKEN` in `.env` / `caspian.env`
   - `preferInstall: true` forces OAuth install even with a token
3. If an **Authorize URL** is returned, tell the user to open it and invite
   the bot to their server. Wait until connection status is `active`.
4. If **RESTART REQUIRED**, say clearly:

   > Restart OpenCode so admit loads `discord` in `channels`. Until then,
   > Discord messages are rejected at the blast-radius wall.

5. Never store the bot token in `caspian.json`.