Skip to content
Get packs

Telegram Archive Search

Lets the agent search and read your local Telegram message archive, chats, contacts and folders.

Source Download skill
Repository
steipete/agent-scripts
Stars
7,433
Licence
MIT
Files
1 file

What it does

This skill teaches an AI agent to answer questions about your Telegram history by querying a local archive database built from your Telegram data, rather than relying on the Telegram apps. It can list chats, read messages, search across them, look up contacts and folders, and import fresh data from Telegram Desktop or the macOS Telegram app. It also covers encrypted backups of that archive to a git repository.

Great for

  • People who want an AI assistant to search or summarise their own Telegram conversations
  • Developers or power users already running the telecrawl command-line tool who want the agent to use it correctly
  • Users who keep a Telegram archive across several Macs and want the agent to pull from a central archive host

Skip it if

  • Anyone wanting to read or send Telegram messages in real time, since the skill is for archived history and live state needs the Telegram apps
  • Users uncomfortable with an agent reading private messages, because the archive contains sensitive personal conversations
  • Setups without the telecrawl CLI installed, since the skill only instructs its use and does not provide it

Try asking

  • “Search my Telegram history for where we discussed the apartment lease”
  • “Show my unread Telegram chats from the last week”
  • “List the messages in my family group since January 1, 2026”
  • “Import the latest data from my Telegram Desktop app and tell me if anything failed”
Step-by-step guide: how to use Telegram Archive SearchInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the MIT licence and an attribution note.

    telecrawl.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip telecrawl.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip telecrawl.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Ask the agent to run status first so it can confirm the archive is populated before answering
  • Be specific about the chat or date range to keep queries small and fast
  • Review any import or restore request yourself, since --restore replaces the archive and the skill says to confirm first

What's inside

  • SKILL.md

Redistributed unmodified from steipete/agent-scripts under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.