BayramAnnakov/telegram-assistant-skill

Claude Code skill for Telegram automation: digests, style extraction, channel posting

License:MITLanguage:N/A103

Deep Analysis

Telegram workflow automation skill supporting message summaries, style extraction, and channel publishing drafts

Core Features

Technical Implementation

Highlights
  • Draft safety - Never sends messages directly
  • Style matching - Extract and replicate writing style
  • MCP integration - telegram-mcp server
  • AgentSkills.io - Open standard compliant
  • Priority classification - Messages categorized by importance
Use Cases
  • Generating Telegram message summaries
  • Analyzing channel writing style
  • Drafting channel posts
  • Morning message summaries
  • AI-assisted content creation
Limitations
  • Requires telegram-mcp server
  • Requires Telegram API credentials
  • Some features depend on unmerged PR
  • MCP configuration is complex
  • English documentation
Tech Stack
Claude Skillstelegram-mcpTelegram APIMCP

Telegram Assistant Skill

A Claude Code skill for automating Telegram workflows: digests, channel posting, and style-matched drafts.

Features

  • Digest Workflow: Summarize unread messages across all chats with priority classification
  • Style Extraction: Analyze channel posts to capture writing style patterns
  • Post Workflow: Draft posts matching your authentic voice, saved as drafts for review

Requirements

Installation

  1. Clone this repo:
git clone https://github.com/BayramAnnakov/telegram-assistant-skill.git
  1. Symlink to Claude skills directory:
ln -s /path/to/telegram-assistant-skill ~/.claude/skills/telegram-assistant
  1. Restart Claude Code

  2. Verify the skill is detected:

Ask Claude: "use the telegram-assistant skill to show my unread messages"

Usage

Digest Workflow

Triggers: "telegram digest", "unread messages", "morning summary"

"Show me a digest of my unread Telegram messages"
"Summarize what I missed in Telegram today"

Style Extraction

Triggers: "analyze writing style", "extract style from channel"

"Analyze the writing style of my ProductsAndStartups channel"
"Extract style patterns from @cryptoEssay"

Post Workflow

Triggers: "post to channel", "draft telegram post", "write for channel"

"Draft a post about MCP for my channel using my style"
"Write a channel post about AI agents"

Safety

This skill follows a draft-first policy:

  • Never sends messages directly via send_message
  • Always uses save_draft so you can review in Telegram before sending
  • Drafts appear in the chat input field in your Telegram app

Dependencies

This skill works best with the following PRs merged into telegram-mcp:

  • PR #45: Draft management tools (save_draft, get_drafts, clear_draft)
  • PR #46: Fix unread detection (unread_mark flag)
  • PR #47: macOS Keychain support for secure credential storage

Until merged, you can use the fork with these features.

File Structure

telegram-assistant/
β”œβ”€β”€ SKILL.md              # Main skill file (AgentSkills.io compliant)
β”œβ”€β”€ README.md             # This file
β”œβ”€β”€ LICENSE               # MIT License
└── references/
    β”œβ”€β”€ setup.md          # Installation guide for telegram-mcp
    └── style-guide.md    # Generated style guide (per-channel)

AgentSkills.io Compliance

This skill follows the AgentSkills.io open standard:

  • Valid YAML frontmatter with required fields
  • Trigger-based activation (not slash commands)
  • Clear workflow documentation

License

MIT

Author

Bayram Annakov (@BayramAnnakov)


Co-created with Claude using the telegram-assistant skill itself.