| name | bot-channel-task |
| description | Standard flow for receiving channel tasks. Immediate acknowledgment, background execution, completion notification. Follow this skill when receiving channel messages. |
| model | sonnet |
| effort | medium |
Bot Channel Task Skill
Standard processing flow for tasks received via messaging channels (e.g., Telegram). Only active when a channel plugin is installed and connected.
Overview
[Channel message received]
|
v
+----------------------+
| 1. Immediate ack | <- Required, highest priority
| "Got it, I'll do X" |
+----------------------+
|
v
+------------------------------------------+
| Task classification |
| |
| Short (1-2 tools) --> Sync execution |
| Long / multi-step --> Background agent |
+------------------------------------------+
|
+-- [Sync] Execute -> completion notification
|
+-- [BG] Launch Agent (run_in_background=true)
|
+-- Progress report if applicable
+-- Completion notification
Step 1: Immediate acknowledgment (required)
After receiving a channel message, reply to the channel first.
Channel detection:
<channel source="plugin:telegram:telegram"> -> mcp__plugin_telegram_telegram__reply
Reply format: "Got it, I'll [action]." (one sentence, concise)
reply_to: message_id from the received message
Step 2: Task execution
Short tasks (1-2 tools)
- Synchronous execution is fine
- Report results to channel after completion
Long tasks (research, implementation, multiple operations)
- Launch subagent via
Agent tool with run_in_background=true
- Main session returns to message listening immediately
Handoff info for background subagent
Task: [specific task content]
Channel: [channel source from received message]
chat_id: [chat_id from received message]
reply_to: [original message_id]
Instructions:
- Report via the channel's reply tool when work is complete
- Send intermediate progress updates for long tasks
- Report errors immediately
Step 3: Completion notification
Send results to channel after work is done.
- Briefly describe what was done and the outcome
- Include error details and remediation if applicable
Job Management via Conversation
Users can manage scheduled jobs through natural conversation:
- "Add a job that checks the server every hour" -> bot calls
/bot-jobs add internally
- "Show my jobs" -> bot calls
/bot-jobs list
- "Pause the daily-report job" -> bot calls
/bot-jobs pause daily-report
The bot interprets the user's intent and invokes the appropriate /bot-jobs subcommand.
Usage
This skill triggers automatically when the bot receives a channel message via Claude Code Channels routing. It is not invoked manually. Only active when a Channels plugin (e.g., Telegram) is installed.
