# Send Telegram Todo List to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "telegram-todolist",
    "name": "Telegram Todo List",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/hengbo12345/telegram-todolist",
    "canonicalUrl": "https://clawhub.ai/hengbo12345/telegram-todolist",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/telegram-todolist",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=telegram-todolist",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/todolist.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/telegram-todolist"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/telegram-todolist",
    "downloadUrl": "https://openagent3.xyz/downloads/telegram-todolist",
    "agentUrl": "https://openagent3.xyz/skills/telegram-todolist/agent",
    "manifestUrl": "https://openagent3.xyz/skills/telegram-todolist/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/telegram-todolist/agent.md"
  }
}
```
## Documentation

### Telegram Todo List

Manage a Todo List stored in TODO.md through Telegram bot commands.

### 1. 查询 (query)

Usage: /todo query

Description: Display current todo list with status

Behavior:

Read TODO.md file
Parse tasks (both completed [x] and pending [ ])
Format and display in clean table/list
Show statistics (total tasks, completed, pending)

Example Output:

📋 待办事项列表

今日任务 (2026-02-12)

- [ ] 学习并掌握 skill-creator 技能介绍
  - 理解技能创建的核心原则

待办总数：6 项未完成
已完成：1 项

### 2. 整理 (organize)

Usage: /todo organize

Description: Update, optimize, or restructure the todo list

Behavior Options:

Add new task: User specifies task content
Delete task: User specifies task number to remove
Move task: Change task priority/order
Edit task: Modify task content or check/uncheck status
Batch operations: Add multiple tasks at once

Input Format:
\`\`/todo organize <action> <details>

**Actions**:
- \`add\`: Add new task(s)
- \`delete\`: Remove task by number
- \`move\`: Move task to different position
- \`edit\`: Modify task content
- \`check\`: Mark task as completed
- \`uncheck\`: Mark task as uncompleted

**Example**:
\`\`/todo organize add 学习Markdown语法
/todo organize delete 3
/todo organize move 1 to top

### 3. 执行 (execute)

Description: Complete a specific task

Behavior:

Mark task as completed [x]
Update timestamp
Remove from active list
Move to completed section
Show confirmation

Input Format:
\`\`/todo execute <task_number>

**Example**:
\`\`/todo execute 1

### File Structure

Storage: TODO.md in workspace root

/root/.openclaw/workspace/TODO.md

File Format:

# TODO List

## 今日任务 (2026-02-12)

- [ ] **Task 1**
  - Subtask 1
  - Subtask 2

- [ ] **Task 2**

---

## 待完成任务

### Category
- [ ] **Task 3**

---

## 已完成任务

- [x] **Completed Task**
  - 记录时间：2026-02-12 07:55 UTC
  - 内容：Task description

### Parsing Tasks

Regular Expression:

- \\[([ x])\\]\\s*\\*\\*(.+?)\\*\\*.*?$         # Main task
  - (.+)$                                 # Subtasks

Status:

[x] = completed
[ ] = pending

### Display Format

Clean Table:

📋 待办事项

今日任务 (2026-02-12)
1. [ ] Task 1
2. [ ] Task 2

待办总数：2 项未完成
已完成：0 项

### Error Handling

Task Not Found:

"未找到任务 #N"
Ask user to verify task number

Invalid Format:

"格式错误，请使用正确的命令格式"
Show usage example

File Read Error:

"无法读取 TODO.md，请检查文件权限"
Try to recreate default template

### User Experience

Confirmation Messages:

Task completed: "✅ 已完成任务 #N"
Task deleted: "🗑️ 已删除任务 #N"
Task added: "➕ 已添加任务"

Progress Indicators:

Show real-time count updates
Calculate completion percentage
Highlight pending vs completed

### Tips

Task Numbers: Always reference task by number in organize/execute commands
Indentation: Keep consistent spacing for subtasks
Comments: Lines starting with # are ignored
Status Updates: Execute updates both visual status and file content

### User: /todo query

Bot shows full todo list

### User: /todo organize add 学习CSS

Bot adds task and shows confirmation

### User: /todo execute 2

Bot marks task #2 as completed and updates list

### User: /todo organize delete 5

Bot removes task #5 from list
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: hengbo12345
- Version: 1.0.1
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/telegram-todolist)
- [Send to Agent page](https://openagent3.xyz/skills/telegram-todolist/agent)
- [JSON manifest](https://openagent3.xyz/skills/telegram-todolist/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/telegram-todolist/agent.md)
- [Download page](https://openagent3.xyz/downloads/telegram-todolist)