Agent skill

Caspian Connect Discord

by TryCaspian in TryCaspian/caspian-sdk

Connect Caspian Discord for OpenCode (install OAuth or BYO bot token), enable discord in caspian.json channels, and tell the user to restart.

Apache-2.0Auto-check: notesBackend & APIs

Install Caspian Connect Discord

skills CLI
$ npx skills add TryCaspian/caspian-sdk --skill caspian-connect-discord -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install TryCaspian/caspian-sdk caspian-connect-discord --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/TryCaspian/caspian-sdk.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/opencode/src/skills/caspian-connect-discord .claude/skills/caspian-connect-discord && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
caspian-connect-discord
GitHub stars
973
Token cost
~376 tokens
SKILL.md length
145 words
Files
1
Skills in repo
8
Repo updated
First seen
Licence
Apache-2.0

At a glance

Connect Caspian Discord for OpenCode (install OAuth or BYO bot token), enable discord in caspian.json channels, and tell the user to restart.

  • Works in 5 steps: Call caspian_connections. → Call caspian_connect_discord. → If an Authorize URL is returned, tell… → …
  • Linking Discord
  • SKILL.md covers When to use and How
  • Needs DISCORD_BOT_TOKEN

What it does

Caspian Connect Discord is an agent skill from TryCaspian/caspian-sdk. 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.

Its SKILL.md is about 380 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: opencode

It sits in Backend & APIs, covering Messaging and chat bots and OAuth and OpenID Connect. It works with Discord and Telegram. The repository describes itself as: Agent communication SDK. The open-source agent communication layer for AI agents — email, WhatsApp, Slack, Discord, Telegram, SMS. Python & TypeScript. The licence is Apache-2.0.

When your agent uses it

  • Linking Discord
  • Running /caspian:connect-discord

Example prompts

  • “/caspian-connect-discord”

Requirements

  • A credential in DISCORD_BOT_TOKEN
  • Compatibility (from SKILL.md): opencode

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Call caspian_connections.
  2. Call caspian_connect_discord.
  3. If an Authorize URL is returned, tell the user to open it and invite
  4. If RESTART REQUIRED, say clearly
  5. Never store the bot token in caspian.json.

What it can do on your machine

Read from SKILL.md and the folder at commit 718a96d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • DISCORD_BOT_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    opencode

    From compatibility in the SKILL.md frontmatter.

Context cost

Caspian Connect Discord loads about 376 tokens when it runs. Until then it costs about 57 tokens; SKILL.md has 145 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~57
When it runs · the whole SKILL.md, loaded when a task matches
~376

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:33
    - Or BYO: `DISCORD_BOT_TOKEN` in `.env` / `caspian.env`

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from TryCaspian/caspian-sdk at commit 718a96d, republished under its Apache-2.0 licence (© TryCaspian). 145 words, ~376 tokens.

Download SKILL.mdSave it as .claude/skills/caspian-connect-discord/SKILL.md (or your agent's skills folder).
name
caspian-connect-discord
description
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.
compatibility
opencode
license
Apache-2.0
metadata.alias
caspian:ConnectDiscord
metadata.channel
caspian

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.

© TryCaspian, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in packages/opencode/src/skills/caspian-connect-discord of TryCaspian/caspian-sdk.

Open the folder on GitHubat commit 718a96d

Compare with similar skills

Caspian Connect Discord next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Caspian Connect Discord compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Caspian Connect Discord this skillTryCaspian/caspian-sdk973—~376Automated safety check: NotesApache-2.0
LangBot EBA Adapter Developmentlangbot-app/LangBot18k—~4kAutomated safety check: PassApache-2.0
Openloomi Connectorsmelandlabs/openloomi1k—~3.3kAutomated safety check: PassApache-2.0
Chat SDKdatabuddy-analytics/Databuddy1.2k—~2.6kAutomated safety check: PassAGPL-3.0
Add Channel Connect Buttonnovuhq/novu40k—~1.6kAutomated safety check: PassCustom licence
Claude To Imop7418/Claude-to-IM-skill2.9k—~3.4kAutomated safety check: NotesMIT

Similar skills

  • Guides building, migrating and testing LangBot messaging-platform adapters for the Event-Based Agents layout, with unified event and message conversion.

    18k GitHub stars~4k tokensUpdated today
    Backend & APIsAuto-check passed
  • Openloomi Connectors

    melandlabs/openloomi

    openloomi Connectors tools - manage the native 7 messaging integrations and pair with the composio skill for the 1000+ apps OAuth layer (Slack, Discord, X, Gmail, Outlook, Google…

    1k GitHub stars~3.3k tokensUpdated 17 days ago
    Productivity & AutomationAuto-check passed
  • Chat SDK

    databuddy-analytics/Databuddy

    Build multi-platform chat bots with Chat SDK (chat npm package).

    1.2k GitHub stars~2.6k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Build a new channel Connect button (e.g. An agent skill from novuhq/novu.

    40k GitHub stars~1.6k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Claude To Im

    op7418/Claude-to-IM-skill

    Bridge THIS Claude Code or Codex session to Telegram, Discord, Feishu/Lark, QQ, or WeChat so the user can chat with Claude from their phone.

    2.9k GitHub stars~3.4k tokensUpdated 6 mo ago
    Productivity & AutomationAuto-check: notes
  • Drives the traul CLI to sync, search and monitor messages from Slack, Telegram, Discord, Linear, Gmail, WhatsApp, Claude Code sessions and Markdown files.

    112 GitHub stars~3.9k tokensUpdated 5 mo ago
    Productivity & AutomationAuto-check: notes

More from TryCaspian/caspian-sdk

All 8 skills in this repo
  • Caspian Toast Test

    TryCaspian/caspian-sdk

    Dummy skill to test OpenCode TUI toast UI (and optional system notification) via caspiantesttoast.

    973 GitHub stars~267 tokensUpdated 1 mo ago
    Auto-check passed
  • Caspian Connect Email

    TryCaspian/caspian-sdk

    Connect Caspian email for OpenCode: ensure credentials (sandbox or dashboard API key), write caspian.env, connect inbox, enable email in caspian.json.

    973 GitHub stars~566 tokensUpdated 1 mo ago
    Auto-check: notes
  • Taste

    TryCaspian/caspian-sdk

    Domain-first store/port design for any codebase: product-shaped APIs, swappable backends, schema at boundaries, one vocabulary catalog (derive don’t re-author), no infrastructure names on the domain…

    973 GitHub stars~1.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Caspian Connect Telegram

    TryCaspian/caspian-sdk

    Connect Caspian Telegram for OpenCode, enable telegram in caspian.json channels, and tell the user to restart.

    973 GitHub stars~446 tokensUpdated 1 mo ago
    Auto-check: notes
  • Caspian Discord

    TryCaspian/caspian-sdk

    Post a Discord message via Caspian to a channel snowflake id.

    973 GitHub stars~323 tokensUpdated 1 mo ago
    Auto-check passed
  • Caspian Inbox

    TryCaspian/caspian-sdk

    Caspian Inbox (caspian:Inbox) — list agent email and other configured channel conversations/messages.

    973 GitHub stars~347 tokensUpdated 1 mo ago
    Auto-check passed

Works with

Questions about Caspian Connect Discord

What does Caspian Connect Discord do?

Connect Caspian Discord for OpenCode (install OAuth or BYO bot token), enable discord in caspian.json channels, and tell the user to restart. Caspian Connect Discord is an agent skill from TryCaspian/caspian-sdk.json channels, and tell the user to restart.

When should I use Caspian Connect Discord?

Caspian Connect Discord fits situations like: linking Discord; running /caspian:connect-discord.

How do I install Caspian Connect Discord in Claude Code?

Run `npx skills add TryCaspian/caspian-sdk --skill caspian-connect-discord -a claude-code`. Or copy the skill folder (packages/opencode/src/skills/caspian-connect-discord in TryCaspian/caspian-sdk) into .claude/skills/caspian-connect-discord in your project. Claude Code loads it when a task matches its description.

How do I install Caspian Connect Discord in Codex?

Run `npx skills add TryCaspian/caspian-sdk --skill caspian-connect-discord -a codex`. Or copy the skill folder (packages/opencode/src/skills/caspian-connect-discord in TryCaspian/caspian-sdk) into .agents/skills/caspian-connect-discord in your project. Codex loads it when a task matches its description.

Can I use Caspian Connect Discord in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add TryCaspian/caspian-sdk --skill caspian-connect-discord -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/caspian-connect-discord, .gemini/skills/caspian-connect-discord, .github/skills/caspian-connect-discord and .opencode/skills/caspian-connect-discord in your project.

What does Caspian Connect Discord need to run?

Going by SKILL.md and its folder, Caspian Connect Discord needs credentials named DISCORD_BOT_TOKEN. Our summary lists: A credential in DISCORD_BOT_TOKEN. Compatibility (from SKILL.md): opencode.

Does Caspian Connect Discord access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Caspian Connect Discord safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Caspian Connect Discord use?

Caspian Connect Discord is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Caspian Connect Discord use?

About 376 tokens (SKILL.md is roughly 1.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Caspian Connect Discord?

Skills that share tags, products or a category with Caspian Connect Discord: LangBot EBA Adapter Development (langbot-app/LangBot, 18k stars), Openloomi Connectors (melandlabs/openloomi, 1k stars), Chat SDK (databuddy-analytics/Databuddy, 1.2k stars) and Add Channel Connect Button (novuhq/novu, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Caspian Connect Discord?

TryCaspian (a GitHub organization) maintains it in TryCaspian/caspian-sdk, which has 973 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on August 25, 2026.

Source: TryCaspian/caspian-sdk on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.