How do I install the Download Media skill?

Run npx skillmds add terrylica/download-media in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Download Media safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Download Media?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Download Media free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Download Media?

terrylica (@terrylica) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Download Media by terrylica — Agent Skill

Name: Download Media
Rating: 4.2 (5 reviews)
Author: terrylica

File contents

Download Telegram Media

Download photos, videos, documents, and other media from Telegram messages.

Self-Evolving Skill: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.

Preflight

Session must exist: ~/.local/share/gramjs/<profile>.session
- If missing, run /tlg:setup first

Usage

/usr/bin/env bash << 'EOF'
ROOT="$(cc-plugin-root tlg)"
SCRIPT="$ROOT/scripts/tg-cli.ts"

# Step 1: Find message ID with media
bun "$SCRIPT" read <chat> -n 10

# Step 2: Download by message ID
bun "$SCRIPT" download <chat> <message_id>

# Download to specific directory
bun "$SCRIPT" download 2124832490 471931 -o ./downloads
EOF

Parameters

Parameter	Type	Description
chat	string/int	Chat containing the message
message_id	int	ID of message with media
`-o/--output`	path	Output directory (default: current)

Workflow

Use read <chat> -n N to browse messages and find IDs
Messages with media show [media/service] in text
Use download <chat> <id> to save the file

Error Handling

Error	Cause	Fix
`message not found`	Invalid message ID	Check with `read` first
`has no media`	Text-only message	Choose a message with media

Post-Execution Reflection

After this skill completes, check before closing:

Did the command succeed? — If not, fix the instruction or error table that caused the failure.
Did parameters or output change? — If tg-cli.ts's interface drifted, update Usage examples and Parameters table to match.
Was a workaround needed? — If you had to improvise (different flags, extra steps), update this SKILL.md so the next invocation doesn't need the same workaround.

Only update if the issue is real and reproducible — not speculative.

---name: download-mediadescription: Use when user wants to download, save, or extract media files such as photos, videos, and documents from Telegram messages.--- # Download Telegram Media Download photos, videos, documents, and other media from Telegram messages. > **Self-Evolving Skill**: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues. ## Preflight 1. Session must exist: `~/.local/share/gramjs/<profile>.session` - If missing, run `/tlg:setup` first ## Usage ```bash /usr/bin/env bash << 'EOF' ROOT="$(cc-plugin-root tlg)" SCRIPT="$ROOT/scripts/tg-cli.ts" # Step 1: Find message ID with media bun "$SCRIPT" read <chat> -n 10 # Step 2: Download by message ID bun "$SCRIPT" download <chat> <message_id> # Download to specific directory bun "$SCRIPT" download 2124832490 471931 -o ./downloads EOF ``` ## Parameters | Parameter | Type | Description | | ------------- | ---------- | ----------------------------------- | | chat | string/int | Chat containing the message | | message_id | int | ID of message with media | | `-o/--output` | path | Output directory (default: current) | ## Workflow 1. Use `read <chat> -n N` to browse messages and find IDs 2. Messages with media show `[media/service]` in text 3. Use `download <chat> <id>` to save the file ## Error Handling | Error | Cause | Fix | | ------------------- | ------------------ | --------------------------- | | `message not found` | Invalid message ID | Check with `read` first | | `has no media` | Text-only message | Choose a message with media | ## Post-Execution Reflection After this skill completes, check before closing: 1. **Did the command succeed?** — If not, fix the instruction or error table that caused the failure. 2. **Did parameters or output change?** — If tg-cli.ts's interface drifted, update Usage examples and Parameters table to match. 3. **Was a workaround needed?** — If you had to improvise (different flags, extra steps), update this SKILL.md so the next invocation doesn't need the same workaround. Only update if the issue is real and reproducible — not speculative.

Frequently asked questions