Agent skill

Caspian Inbox

by TryCaspian in TryCaspian/caspian-sdk

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

Apache-2.0Auto-check passedProductivity & Automation

Install Caspian Inbox

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

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

GitHub CLI
$ gh skill install TryCaspian/caspian-sdk caspian-inbox --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-inbox .claude/skills/caspian-inbox && 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-inbox
GitHub stars
973
Token cost
~347 tokens
SKILL.md length
135 words
Files
1
Skills in repo
8
Repo updated
First seen
Licence
Apache-2.0

At a glance

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

  • Works in 4 steps: Call the tool caspian_inbox with list… → Optionally pass → Present the tool output to the user… → …
  • The user asks for inbox
  • SKILL.md covers When to use, How, Address only and Related
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Caspian Inbox is an agent skill from TryCaspian/caspian-sdk. Caspian Inbox (caspian:Inbox) — list agent email and other configured channel conversations/messages. Use when the user asks for inbox, mail, unread email, Slack/Discord/channel messages via Caspian, or runs /caspian:inbox.

Its SKILL.md is about 350 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 Productivity & Automation, covering Email management. It works with Discord and Slack. 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

  • The user asks for inbox
  • Slack/Discord/channel messages via Caspian
  • Runs /caspian:inbox

Example prompts

  • “/caspian-inbox”

Requirements

  • Compatibility (from SKILL.md): opencode

Workflow steps

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

  1. Call the tool caspian_inbox with list true (default).
  2. Optionally pass
  3. Present the tool output to the user (connections + conversations + recent messages).
  4. Do not invent messages. If the tool errors, report the error.

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 no API keys, tokens, secrets or passwords.

    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 Inbox loads about 347 tokens when it runs. Until then it costs about 59 tokens; SKILL.md has 135 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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). 135 words, ~347 tokens.

Download SKILL.mdSave it as .claude/skills/caspian-inbox/SKILL.md (or your agent's skills folder).
name
caspian-inbox
description
Caspian Inbox (caspian:Inbox) — list agent email and other configured channel conversations/messages. Use when the user asks for inbox, mail, unread email, Slack/Discord/channel messages via Caspian, or runs /caspian:inbox.
compatibility
opencode
license
Apache-2.0
metadata.alias
caspian:Inbox
metadata.channel
caspian

Caspian Inbox (caspian:Inbox)

List recent Caspian conversations and messages across configured channels (default: email; also any other channels enabled in plugin config).

When to use

  • User asks “what’s in my inbox?”, “show emails”, “list Caspian messages”
  • User runs /caspian:inbox or /caspian-inbox
  • User mentions unread mail or channel threads on the agent inbox

How

  1. Call the tool caspian_inbox with list true (default).
  2. Optionally pass:
    • channels — e.g. email or email,slack
    • conversationLimit — default 10
    • messageLimit — default 5
  3. Present the tool output to the user (connections + conversations + recent messages).
  4. Do not invent messages. If the tool errors, report the error.

Address only

If the user only wants the agent email address, call caspian_inbox with list: false.

  • Send mail: tool caspian_send_email or /caspian:email
  • Inbound mail is also pushed into OpenCode sessions automatically by the plugin

© 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-inbox of TryCaspian/caspian-sdk.

Open the folder on GitHubat commit 718a96d

Compare with similar skills

Caspian Inbox 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 Inbox compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Caspian Inbox this skillTryCaspian/caspian-sdk973—~347Automated safety check: PassApache-2.0
Ops Inboxdavepoon/buildwithclaude3.6k—~7.2kAutomated safety check: NotesMIT
Openloomi Connectorsmelandlabs/openloomi1k—~3.3kAutomated safety check: PassApache-2.0
Traul Message Searchdandaka/traul112—~3.9kAutomated safety check: NotesAGPL-3.0
Connect Apps with ComposioComposioHQ/awesome-claude-skills77k3 repos~557Automated safety check: PassNone
Composio Cloud Toolsquarqlabs/argus279—~543Automated safety check: PassApache-2.0

Similar skills

  • Ops Inbox

    davepoon/buildwithclaude

    Full inbox management across all channels — WhatsApp (wacli), Email (Gmail MCP), Slack (MCP), Telegram (user-auth MCP), Discord (webhook + REST read), Notion (MCP — comments, mentions, assigned…

    3.6k GitHub stars~7.2k tokensUpdated yesterday
    Productivity & AutomationAuto-check: notes
  • 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 16 days ago
    Productivity & AutomationAuto-check passed
  • 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
  • Connect Apps with Composio

    ComposioHQ/awesome-claude-skills

    Connects an agent to 1000+ external apps through the Composio Tool Router plugin, so it can actually send emails, create issues and post messages instead of only drafting them.

    77k GitHub starsUsed in 3 repos~557 tokens
    Productivity & AutomationAuto-check passed
  • Composio Cloud Tools

    quarqlabs/argus

    Routes requests to external SaaS apps such as GitHub, Gmail, Google Calendar, Slack, Notion and Linear through cloud tools, with safeguards on irreversible actions.

    279 GitHub stars~543 tokensUpdated 4 mo ago
    Productivity & AutomationAuto-check passed
  • Message Push

    0xranx/golembot

    Send proactive messages to IM groups or individual users via the gateway Send API.

    322 GitHub stars~984 tokensUpdated 11 days ago
    Productivity & AutomationAuto-check passed

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 Discord

    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.

    973 GitHub stars~376 tokensUpdated 1 mo ago
    Auto-check: notes
  • 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

Works with

Questions about Caspian Inbox

What does Caspian Inbox do?

Caspian Inbox (caspian:Inbox) — list agent email and other configured channel conversations/messages. Caspian Inbox is an agent skill from TryCaspian/caspian-sdk. Caspian Inbox (caspian:Inbox) — list agent email and other configured channel conversations/messages.

When should I use Caspian Inbox?

Caspian Inbox fits situations like: the user asks for inbox; slack/Discord/channel messages via Caspian; runs /caspian:inbox.

How do I install Caspian Inbox in Claude Code?

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

How do I install Caspian Inbox in Codex?

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

Can I use Caspian Inbox 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-inbox -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-inbox, .gemini/skills/caspian-inbox, .github/skills/caspian-inbox and .opencode/skills/caspian-inbox in your project.

What does Caspian Inbox need to run?

SKILL.md names no scripts, command-line tools or credentials: Caspian Inbox is instructions for the agent only. Compatibility (from SKILL.md): opencode.

Does Caspian Inbox 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 Inbox safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Caspian Inbox use?

Caspian Inbox 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 Inbox use?

About 347 tokens (SKILL.md is roughly 1.4k 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 Inbox?

Skills that share tags, products or a category with Caspian Inbox: Ops Inbox (davepoon/buildwithclaude, 3.6k stars), Openloomi Connectors (melandlabs/openloomi, 1k stars), Traul Message Search (dandaka/traul, 112 stars) and Connect Apps with Composio (ComposioHQ/awesome-claude-skills, 77k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Caspian Inbox?

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.