nova: Skill for Claude Code

.claude/skills/telegram-file-sender/SKILL.md

telegram-file-sender is a skill for Claude Code from djbelieny/nova. It costs 64 tokens per session (596 once invoked), scanned A, original, MIT.

A tool for sending files as document attachments through Telegram using the Telegram Bot API. It can deliver existing files or files generated during a task.

In plain words
What is it for?
Use it after creating or locating a file that someone wants to receive through Telegram, optionally with a caption.
Why use it?
It provides a direct way to deliver reports, images, spreadsheets, presentations, and other files in a Telegram chat. It avoids requiring the recipient to find the file elsewhere.

Skill for Claude Code

Written for Claude Code: installed under .claude/. Also seen: reads .claude/ paths.

This is djbelieny/nova's own configuration. It tells Claude Code how to work on nova itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything nova configures →

Reuse

Borrowing it

Nothing to install: this file belongs to djbelieny/nova. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/djbelieny/nova/main/.claude/skills/telegram-file-sender/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/djbelieny/nova

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for telegram-file-sender

README.md
[![agentmods](https://agentmods.dev/badge/skills/djbelieny/nova/telegram-file-sender/github.svg)](https://agentmods.dev/skills/djbelieny/nova/telegram-file-sender)
Your own site
<a href="https://agentmods.dev/skills/djbelieny/nova/telegram-file-sender"><img src="https://agentmods.dev/badge/skills/djbelieny/nova/telegram-file-sender/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for telegram-file-sender

Your own site · 80×15
<a href="https://agentmods.dev/skills/djbelieny/nova/telegram-file-sender"><img src="https://agentmods.dev/badge/skills/djbelieny/nova/telegram-file-sender.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 64 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 596 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00064 $0.00596
Opus 5 $0.00032 $0.00298
Sonnet 5 $0.00013 $0.00119
Haiku 4.5 $0.00006 $0.00060

Measured 5d ago against content hash 156dcd19e051, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

telegram-file-sender scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/send_telegram_file.sh), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/skills/telegram-file-sender/SKILL.md · 71 lines

How it starts

The opening of the file, as written. The whole thing — 71 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Telegram File Sender

Send any file as a document attachment to the user's Telegram chat using the Telegram Bot API.

When to Use

  • The user asks to "send me" a file, document, report, or any generated output
  • The user says "send it to me on Telegram" or "share that file with me"
  • After generating a file (PDF, DOCX, XLSX, PPTX, image, etc.) that the user wants delivered
  • The user asks to "send this to Telegram" or "attach this"
  • Post-call tasks that involve delivering files to the user

Workflow

1. Locate or Generate the File

Identify the file to send. If the file needs to be created first (e.g., a report, document, spreadsheet), generate it using the appropriate skill or tool before proceeding.

2. Send the File

Execute the bundled script to send the file via Telegram:

~/.claude/skills/telegram-file-sender/scripts/send_telegram_file.sh "<file_path>" "<optional_caption>"

Parameters:

  • file_path (required): Absolute path to the file to send
  • caption (optional): A message to display alongside the file (supports Markdown)

Environment variables (loaded automatically from .env):

  • TELEGRAM_BOT_TOKEN — The bot token
  • TELEGRAM_USER_ID — The recipient's chat ID

3. Confirm Delivery

After the script runs, confirm to the user that the file was sent. If it fails, report the error.

Constraints

  • Maximum file size: 50MB (Telegram Bot API limit)
  • For files larger than 50MB, split or compress the file first, or suggest an alternative delivery method
  • The script validates file existence and size before sending
  • Captions support Markdown formatting

Examples

Send a generated PDF report:

~/.claude/skills/telegram-file-sender/scripts/send_telegram_file.sh "/tmp/quarterly-report.pdf" "Here's your Q1 report"

Send a spreadsheet without caption:

~/.claude/skills/telegram-file-sender/scripts/send_telegram_file.sh "/path/to/budget.xlsx"

Send a presentation with formatted caption:

~/.claude/skills/telegram-file-sender/scripts/send_telegram_file.sh "/tmp/pitch-deck.pptx" "*Pitch deck* — ready for review"

Read the full file on GitHub · 71 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 71 lines · 64 tokens per session scan A 156dcd19e051

Subscribe to this mod's changes

telegram-file-sender is a skill published in the GitHub repository djbelieny/nova (5 stars, last pushed 1mo ago), licensed MIT. It adds 64 tokens to every session and 596 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Related

Other skills, from other repositories

intent-recognition

Classifies automation requests using two decisions: anchor (which primitive owns the top-level control flow — workflow-anchored, agent-anchored, needs-clarification, or out-of-scope) and embedsother (whether the other primitive appears embedded inside — an agent step inside a workflow, or a workflow invoked as an…

n8n-io/n8n · 146 tokens

post-build-flow

Handles workflow verification and setup after build-workflow succeeds, or when the message contains workflow-verification-follow-up or workflow-setup-required. Load after direct builds, when verificationReadiness requires action, or on orchestrator verify/setup follow-up turns.

n8n-io/n8n · 53 tokens

planned-task-runtime

Handles system follow-up turns: planned-task-follow-up (synthesize, replan, build-workflow, checkpoint), background-task-completed, running-tasks context, and create-tasks silence rules. Load whenever any of these tags appear or after calling create-tasks.

n8n-io/n8n · 58 tokens

config-evals

Builds and maintains configuration-based evaluations on a workflow with the eval-config tool. Use when the user asks to set up, add, view, change, or remove an evaluation, score, grade, or judge a workflow's output, or measure answer quality against a test dataset. This is the only eval form Instance AI handles — it…

n8n-io/n8n · 80 tokens

one-off-operations

Handles one-off operations: the request is a concrete effect that happens once — export or copy data somewhere, a migration, a backfill, a cleanup — with no trigger, schedule, or reuse intent. The workflow is the vehicle, not the deliverable. Users rarely say "one-off"; infer it from the task's shape. Load before…

n8n-io/n8n · 123 tokens

debugging-executions

Debug failed or wrong-output workflow executions using executions tools. Load when the user reports execution failures, unexpected node output, empty parameter values after a successful run, or a node showing a red or failed expression error.

n8n-io/n8n · 48 tokens