Agent skill

Caspian Telegram

by TryCaspian in TryCaspian/caspian-sdk

Send a Telegram message via Caspian to a @username (or chat id).

Apache-2.0Auto-check passedProductivity & Automation

Install Caspian Telegram

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

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

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

At a glance

Send a Telegram message via Caspian to a @username (or chat id).

  • Works in 4 steps: Parse to (@username or numeric chat id)… → Call tool caspian_send_telegram with to… → Present the tool output. Always include… → …
  • The user runs /caspian:telegram
  • SKILL.md covers When to use, How and Do not
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Caspian Telegram is an agent skill from TryCaspian/caspian-sdk. Send a Telegram message via Caspian to a @username (or chat id). Use when the user runs /caspian:telegram or asks to DM someone on Telegram through the bot.

Its SKILL.md is about 310 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 Messaging and chat bots. It works with 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

  • The user runs /caspian:telegram
  • Asks to DM someone on Telegram through the bot

Example prompts

  • “/caspian-telegram”

Requirements

  • Compatibility (from SKILL.md): opencode

Workflow steps

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

  1. Parse to (@username or numeric chat id) and body from the user.
  2. Call tool caspian_send_telegram with to and body.
  3. Present the tool output. Always include this side note (even on success)
  4. Do not claim success without a tool result. If the tool fails because there

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 Telegram loads about 305 tokens when it runs. Until then it costs about 43 tokens; SKILL.md has 139 words of instructions outside code blocks.

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

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). 139 words, ~305 tokens.

Download SKILL.mdSave it as .claude/skills/caspian-telegram/SKILL.md (or your agent's skills folder).
name
caspian-telegram
description
Send a Telegram message via Caspian to a @username (or chat id). Use when the user runs /caspian:telegram or asks to DM someone on Telegram through the bot.
compatibility
opencode
license
Apache-2.0
metadata.alias
caspian:Telegram
metadata.channel
caspian

Caspian Telegram send (caspian:Telegram)

Send a message to a Telegram user through the connected Caspian bot.

When to use

  • User runs /caspian:telegram or /caspian-telegram
  • User asks to DM / message someone on Telegram via the agent bot

How

  1. Parse to (@username or numeric chat id) and body from the user.

  2. Call tool caspian_send_telegram with to and body.

  3. Present the tool output. Always include this side note (even on success):

    Telegram: bots cannot start a private chat. The recipient must message your bot first (open the bot → Start / send any message) before DMs work.

  4. Do not claim success without a tool result. If the tool fails because there is no prior conversation, explain they need to Start the bot first.

Do not

  • Use caspian_send_email for Telegram
  • Invent usernames or pretend the DM arrived without a tool result

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

Open the folder on GitHubat commit 718a96d

Compare with similar skills

Caspian Telegram 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 Telegram compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Caspian Telegram this skillTryCaspian/caspian-sdk973—~305Automated safety check: PassApache-2.0
Tlivey49/tlive215—~1.7kAutomated safety check: NotesMIT
Easy Openclawdaheiai/easy-openclaw112—~1.7kAutomated safety check: NotesNone
Im Adapter0xranx/golembot323—~1.4kAutomated safety check: PassMIT
Message Push0xranx/golembot323—~984Automated safety check: PassMIT
Telegramolasunkanmi-SE/codebuddy141—~817Automated safety check: PassMIT

Similar skills

  • Tlive

    y49/tlive

    tlive — remote approvals (Telegram/Feishu/web), live web terminal, and session monitoring for Claude Code / Codex.

    215 GitHub stars~1.7k tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check: notes
  • Easy Openclaw

    daheiai/easy-openclaw

    OpenClaw 配置优化向导。采用“第 0 层测试观测(可选)+ 前 3 轮优化 + 第 4 轮接入扩展”流程:基础推荐层(含联网搜索与权限模式)、渠道增强层(Discord/Feishu/Telegram 分支优化)、Skills 推荐层(可执行可跳过)、新增渠道接入引导(可跳过)。用于帮助用户快速完成 OpenClaw 初始化或优化配置。用户说到“优化…

    112 GitHub stars~1.7k tokensUpdated 6 mo ago
    Productivity & AutomationAuto-check: notes
  • Im Adapter

    0xranx/golembot

    Format responses for instant messaging platforms such as Lark, DingTalk, WeCom, Slack, and Telegram.

    323 GitHub stars~1.4k tokensUpdated 11 days ago
    Productivity & AutomationAuto-check passed
  • Message Push

    0xranx/golembot

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

    323 GitHub stars~984 tokensUpdated 11 days ago
    Productivity & AutomationAuto-check passed
  • Telegram

    olasunkanmi-SE/codebuddy

    Send Telegram messages, files, and interact with Telegram bots via the telegram-send CLI tool.

    141 GitHub stars~817 tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check passed
  • Ak Dev New Messaging Integration

    yaalalabs/agent-kernel

    Step-by-step guide for adding a new messaging platform integration to Agent Kernel.

    192 GitHub stars~4.6k tokensUpdated today
    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 Telegram

What does Caspian Telegram do?

Send a Telegram message via Caspian to a @username (or chat id). Caspian Telegram is an agent skill from TryCaspian/caspian-sdk. Send a Telegram message via Caspian to a @username (or chat id).

When should I use Caspian Telegram?

Caspian Telegram fits situations like: the user runs /caspian:telegram; asks to DM someone on Telegram through the bot.

How do I install Caspian Telegram in Claude Code?

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

How do I install Caspian Telegram in Codex?

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

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

What does Caspian Telegram need to run?

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

Does Caspian Telegram 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 Telegram 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 Telegram use?

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

About 305 tokens (SKILL.md is roughly 1.2k 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 Telegram?

Skills that share tags, products or a category with Caspian Telegram: Tlive (y49/tlive, 215 stars), Easy Openclaw (daheiai/easy-openclaw, 112 stars), Im Adapter (0xranx/golembot, 323 stars) and Message Push (0xranx/golembot, 323 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Caspian Telegram?

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.