b3os-telegram-file-delivery SKILL.md skillA
b3os-telegram-file-delivery from b3rys/b3rys-team-os is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add b3rys/b3rys-team-os/b3os-telegram-file-delivery@git:20260801.9cc5479Pins git:20260801.9cc5479 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- b3rys/b3rys-team-os
- Path
skills/b3os-telegram-file-delivery/SKILL.md- Versions recorded
- 2
- Latest version
- git:20260801.9cc5479, committed Aug 1, 2026
- First version recorded
- Jul 23, 2026
- Size
- 4,817 bytes
- Repository stars
- 18
- License
- Apache-2.0
Telegram으로 파일(HTML·PDF·이미지·ZIP·문서 등)을 보내야 할 때, 막히는 message/첨부 도구 대신 Bot API sendDocument를 안전하게 쓰는 팀 정본 절차.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# b3rys Telegram File Delivery Telegram으로 **파일을 그대로 보내야 할 때** 쓰는 스킬이다. 팀에서 반복되는 실수 = "텔레그램에서 파일이 안 보내진다." 원인은 런타임의 `message`/첨부 도구가 파일 직접 첨부를 보안 제한으로 막거나(특히 OpenClaw/Forin 계열 `.html`), 첨부 경로/형식이 도구 제약에 안 맞는 것이다. **해법은 일관된다 — Telegram Bot API의 `sendDocument`를 직접 호출한다.** HTML만이 아니라 PDF·이미지·ZIP·CSV·로그 등 모든 파일에 동일하게 적용된다. ## 언제 쓰나 - `message`/reply 도구로 파일 첨부가 막히거나 실패할 때 (가장 흔한 케이스). - HTML 산출물을 ZIP으로 우회하지 않고 원본 그대로 보내고 싶을 때. - 보고서(PDF/HTML), 스크린샷(PNG/JPG), 데이터(CSV/JSON), 압축본(ZIP) 등 어떤 파일이든 텔레그램으로 보내야 할 때. ## 원칙 - 파일 전송이 도구로 막히면 ZIP/링크로 우회하기 **전에** 이 스킬(`sendDocument`)을 먼저 쓴다. - 외부 전송이므로 the team lead 또는 요청자의 명시 컨펌을 받은 뒤 보낸다. - bot token(봇 토큰), chat id(채팅방 ID), credential은 env/profile에서 읽고 stdout에 노출하지 않는다. - 성공 여부는 Telegram API 응답의 `ok`, `message_id`, 파일명만 보고한다. 토큰·전체 응답·chat id는 불필요하게 출력하지 않는다. ## 필요한 값 - `TELEGRAM_BOT_TOKEN`: 보낼 봇의 token (Hermes profile env, OpenClaw account env 등). - `TELEGRAM_CHAT_ID`: 대상 채팅방 또는 DM id. - 파일 경로: 실제 존재하는 파일. - 선택 caption: 짧게. ## 파일 형식별 MIME 타입 `document=@경로;type=<mime>` 로 명시하면 텔레그램이 올바르게 인식한다. (생략해도 대개 동작하지만 HTML 등은 명시 권장.) | 파일 | MIME | |---|---| | `.html` | `text/html` | | `.pdf` | `application/pdf` | …
Read the whole file at its exact version.
How to install
mdr add b3rys/b3rys-team-os/b3os-telegram-file-delivery@sha256:25ca3c7caf9f0f8cThe line at the top of this page pins the label git:20260801.9cc5479, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_ilmhlrnptxawlcbh)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 2 versions of this file, between Jul 23, 2026 and Aug 1, 2026, about one every 9 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260801.9cc5479 latest | 2026-08-01 | 9cc5479 | 4,817 B | A | view · diff |
| git:20260723.55ddc12 | 2026-07-23 | 55ddc12 | 4,759 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (4817 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
b3rys/b3rys-team-os · 18 stars · license Apache-2.0 · pushed 2026-11-06 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_ilmhlrnptxawlcbh GET https://markdownregistry.com/api/v1/resolve?ref=b3rys/b3rys-team-os/b3os-telegram-file-delivery GET https://markdownregistry.com/api/v1/blob/25ca3c7caf9f0f8c0ede534e8059d5a3daa910b3c335aeb628e4c14b388e4230
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.