Create skills/ folder with MCP server usage guide and practical Telegram automation examples (summarize unread, draft replies without sending, etc.)
As a developer or agent integrator,
I would like a dedicated `skills/` documentation folder that explains how to use the `telegram-mcp` server
and provides concrete example workflows
(e.g., summarize latest unread messages and draft responses without sending)
so that I can reliably adopt the server capabilities with minimal trial-and-error.
Background
The repository provides a Telegram MCP server but lacks a centralized, “skill-oriented” documentation set that:
- explains end-to-end usage (setup, configuration, connecting an MCP client, and typical call patterns), and
- offers ready-to-copy examples for common user workflows (summarization, drafting replies, triage, etc.), including safe patterns such as drafting responses without sending messages.
Adding a skills/ folder with standardized skill descriptions will improve onboarding, reduce integration friction, and provide canonical examples for agents.
Scope
Create a new folder containing skill-style markdown documents:
- one primary guide describing how to use this MCP server, and
- one or more example skill documents describing common use cases (including “draft but do not send”).
Proposed Folder Structure
skills/
README.md (index + quick navigation)
how-to-use-telegram-mcp.md (main “how to use” guide)
examples/
summarize-latest-unread.md
draft-replies-without-sending.md
triage-and-action-items.md (optional but recommended)
search-chat-and-summarize-context.md (optional but recommended)
Documentation Template (to apply per skill doc)
Each skill document must include:
- Skill Name
- Purpose
- When to Use / Use Cases
- Prerequisites / Configuration
- MCP Tools Used (tool names + parameters + notes)
- Inputs (what the agent/user provides)
- Outputs (what the agent returns)
- Step-by-step Example (prompt → tool calls → response)
- Safety / Privacy Notes
- Failure Modes & Recovery (e.g., auth expired, rate limit, missing chat id)
Acceptance Criteria
Implementation Notes
- This issue is documentation-focused. No server behavior changes are required unless the current toolset lacks a safe way to support the documented examples (in which case, document the limitation and file a follow-up issue).
- For the “draft replies without sending” example, ensure the steps explicitly avoid any tool/action that transmits messages. The example should return drafts for user review only.
Definition of Done
The skills/ folder is merged with the main usage guide and at least two example skill documents (summarize unread; draft without sending), referenced from the root documentation entrypoint, and written in a consistent, actionable format.
Create
skills/folder with MCP server usage guide and practical Telegram automation examples (summarize unread, draft replies without sending, etc.)Background
The repository provides a Telegram MCP server but lacks a centralized, “skill-oriented” documentation set that:
Adding a
skills/folder with standardized skill descriptions will improve onboarding, reduce integration friction, and provide canonical examples for agents.Scope
Create a new folder containing skill-style markdown documents:
Proposed Folder Structure
skills/README.md(index + quick navigation)how-to-use-telegram-mcp.md(main “how to use” guide)examples/summarize-latest-unread.mddraft-replies-without-sending.mdtriage-and-action-items.md(optional but recommended)search-chat-and-summarize-context.md(optional but recommended)Documentation Template (to apply per skill doc)
Each skill document must include:
Acceptance Criteria
skills/folder exists at the repository root.skills/README.mdprovides:skills/how-to-use-telegram-mcp.mdincludes, at minimum:skills/examples/summarize-latest-unread.mdincludes:skills/examples/draft-replies-without-sending.mdincludes:README.md(or equivalent primary docs entrypoint) links toskills/.Implementation Notes
Definition of Done
The
skills/folder is merged with the main usage guide and at least two example skill documents (summarize unread; draft without sending), referenced from the root documentation entrypoint, and written in a consistent, actionable format.