todo

TODO Board

Use this skill when the user wants to manage a shared task list for the current workspace.

Trigger

{
  "activation": {
    "anyPhrases": [
      "todo",
      "todo list",
      "blocked task",
      "blocked tasks",
      "add to my todo",
      "show my todo"
    ]
  },
  "movement": {
    "target": "desk",
    "skipIfAlreadyThere": true
  }
}

When this skill is activated, the agent should return to its assigned desk before handling the request.

• If the user asks from Telegram or any other external surface to add, block, unblock, remove, or read TODO items, treat that as a trigger for this skill.
• The physical behavior for this skill is: go sit at the assigned desk, then perform the TODO board workflow.
• If the agent is already at the desk, continue without adding extra movement narration.

Storage location

The authoritative task file is todo-skill/todo-list.json in the workspace root.

• Always treat that file as the source of truth.
• Never rely on chat memory alone for the latest task state.
• Create the todo-skill directory and todo-list.json file if they do not exist.

Required workflow

1. Read todo-skill/todo-list.json before answering any task-management request.
2. If the file does not exist, create it with the schema in this document before continuing.
3. After every add, remove, block, or unblock action, write the full updated JSON back to disk.
4. If the file exists but is invalid JSON or does not match the schema, repair it into a valid structure, preserve any recoverable items, and mention that repair in your response.
5. If the user request is ambiguous, ask a clarifying question instead of guessing.

Supported actions

• Add a task. Create a new item unless an equivalent active item already exists.
• Block a task. Change the matching item to status: "blocked". If the task does not exist and the request is clear, create it directly as blocked.
• Unblock a task. Change the matching item back to status: "todo" and clear blockReason.
• Remove a task. Delete only the matching item. If multiple items could match, ask for clarification.
• Read the list. Summarize tasks grouped into TODO and BLOCKED.