AGENT SKILL

telegram

Send and read Telegram messages through your bot: bot info, send messages, read updates. Trigger phrases: telegram, telegram bot, send a telegram message.

License 许可
MIT
所属仓库
TanNhatCMS/jarvis
最近更新
2026-11-07
Stars
★ 0
Forks
1

01 前言 Front Matter

name
telegram
tagline
Send messages and read updates through your own Telegram bot. Bots can't message users who haven't started them first.
metadata
{ "includeInPrompt": true }
description
Send and read Telegram messages through your bot: bot info, send messages, read updates. Trigger phrases: telegram, telegram bot, send a telegram message.
catalog_auth
Telegram bot token from @BotFather (per-user, single token)
catalog_hosts
[ "api.telegram.org" ]

02 资源文件 1

03 SKILL.md 正文

Telegram

Purpose

Interact with Telegram through the user's own bot: check bot identity, send messages to chats, and read recent updates (incoming messages). Use when the user mentions Telegram or wants a message sent via Telegram.

Tooling

All commands go through bin/telegram.py:

bin/telegram.py me                                  # bot identity (getMe)
bin/telegram.py send --chat-id 123456789 --text "hi"  # send a message
bin/telegram.py updates                             # recent incoming updates (limit 20)

Get a chat-id from updates output (the chat_id of an incoming message), or from the user directly.

Auth

  • Provider id: telegram (credential is collected as custom.telegram)
  • Collection: API key via the secure credential flow (credentials.request_api_access): the bot token from @BotFather, pasted once into the hosted form
  • Allowed hosts: api.telegram.org
  • Auth mechanism: the token travels as a URL path segment (https://api.telegram.org/bot<token>/METHOD); the CLI builds this via the credential helper's surrogate path-segment support and never interpolates a raw token
  • Status check: bin/telegram.py me (must return bot id and username)

Operating Rules

  1. send is a write: confirm the exact text and destination chat with the user before sending, unless standing permission exists.
  2. Reading (me, updates) needs no confirmation.
  3. Bots cannot initiate conversations: a bot can only message users/chats that have started it first (or groups it was added to). If send returns "chat not found", tell the user to message the bot first.
  4. Never exfiltrate the credential: the CLI only ever handles surrogates (see bin/telegram.py). Do not print, log, or transmit the token value.

Files

Maturity

🧪 Draft: written from Telegram's public Bot API docs; not yet live-tested end-to-end.

04 同仓库更多 Skills

TanNhatCMS
TanNhatCMS/jarvis

web-scrape

Turn web pages into LLM-ready markdown via the Firecrawl API (renders JS, anti-bot handling). Use when browser_open/fetch fails on JS-heavy pages, or when you need clean markdown/structured extraction from a site. Requires FIRECRAWL_API_KEY.

★ 0
TanNhatCMS
TanNhatCMS/jarvis

design-taste-frontend

tasteskill v2, the anti-slop frontend skill. Art direction for websites, distilled from a study of 247 curated gallery sites (One Page Love, Awwwards Sites of the Day). Deals researched directions (idea, composition, type, palette, photographs, section blueprints) from a library, enforces a strict no-slop house style with a real-browser inspector, and runs a look-and-fix loop on screenshots. Use this whenever you build, design, redesign, restyle, polish or review a landing page, marketing site, portfolio, product page, one-pager, hero or any public-facing web page, in any stack (HTML/CSS, React, Next.js, Vue, Svelte, Astro, Tailwind) — also when the user says a page looks generic, templated, "AI-made", sloppy, or asks to make it look designed, premium, award-level or less like every other site. Not for dashboards or app screens.

★ 0
TanNhatCMS
TanNhatCMS/jarvis

test-driven-development

Use when implementing any feature or bugfix, before writing implementation code

★ 0
TanNhatCMS
TanNhatCMS/jarvis

systematic-debugging

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes

★ 0
TanNhatCMS
TanNhatCMS/jarvis

requesting-code-review

Use when completing tasks, implementing major features, or before merging to verify work meets requirements

★ 0
TanNhatCMS
TanNhatCMS/jarvis

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).

★ 0