| name | todoist-tasks |
| description | This skill should be used when the user asks to "add a task", "create a Todoist task", "complete a task", "mark task as done", "update a task", "delete a task", "show my tasks", "what's due today", "list my Todoist tasks", "check my to-dos", "what do I need to do", or mentions Todoist task management, to-do items, or task queries by project, priority, label, or due date. Delegates all operations to the todoist-agent subagent.
|
Todoist Task Operations
All task operations delegate to the todoist-agent subagent via natural language.
Batch-First Delegation
Collect all items from the user's request before delegating. One delegation per operation type:
- Multiple creates → list all tasks in one delegation
- Multiple completions → list all task names/IDs in one delegation
- Never call the agent separately for each item in a batch
Delegation Conventions
When describing tasks to the agent, use these formats:
- Priority: p1 (highest) through p4 (lowest/default)
- Project: use the project name as the user said it
- Due dates: pass through natural language ("tomorrow", "next Friday", "March 15")
- Labels: prefix with @ if the user doesn't
Examples
- "Create a task 'Review PR #42' in Work, p2 priority, due tomorrow"
- "Complete these tasks: Deploy hotfix, Update docs, Close issue #99"
- "Show tasks due today"
- "Create 3 tasks in Personal: Buy groceries (due today), Call dentist (due Monday, p2), Renew subscription (due March 1)"
Error Recovery
If the agent reports a project, label, or section "not found":
- Invoke
todoist:todoist-sync to refresh structure
- Retry the original operation once
- If still failing, report to the user — the entity may not exist
