Scheduler Tasks
Use the scheduler tool to manage saved tasks. Always inspect existing tasks before creating, updating, deleting, or running one.
Actions
list_tasks: optional state[], type[], next_run_within, next_run_after
find_task_by_name: name
show_task: uuid
run_task: uuid, optional context
update_task: uuid, optional name, system_prompt, prompt, attachments[], schedule, timezone, plan[], state, dedicated_context
delete_task: uuid
create_scheduled_task: name, system_prompt, prompt, optional attachments[], schedule, timezone, dedicated_context
create_adhoc_task: name, system_prompt, prompt, optional attachments[], dedicated_context
create_planned_task: name, system_prompt, prompt, optional attachments[], plan[], dedicated_context
wait_for_task: uuid
Schedule Fields
Schedules use cron-like fields. Do not put ISO datetimes into schedule.
minute
hour
day
month
weekday
timezone
Use IANA timezones such as Europe/Rome. Omit timezone to use the current user timezone. Planned task datetimes go in plan, not schedule, and should be ISO strings such as 2026-05-09T18:25:00.
For one future reminder, prefer create_planned_task with:
{
"action": "create_planned_task",
"name": "drink water",
"prompt": "Remind the user to drink water.",
"plan": ["2026-05-11T09:15:00"],
"dedicated_context": true
}
For a recurring or cron-shaped scheduled task, use create_scheduled_task with:
{
"action": "create_scheduled_task",
"name": "weekday stretch",
"prompt": "Remind the user to stretch.",
"schedule": {
"minute": "15",
"hour": "9",
"day": "*",
"month": "*",
"weekday": "1-5",
"timezone": "Europe/Rome"
},
"dedicated_context": true
}
Safety
- Do not create recursive task prompts that schedule more tasks.
- Do not run a task just because it is scheduled; run only if the user asks.
- Created tasks use a dedicated context unless
dedicated_context is explicitly false.
- For destructive operations, identify the task by UUID after lookup.
Example
{
"tool_name": "scheduler",
"tool_args": {
"action": "find_task_by_name",
"name": "daily backup"
}
}
1---
2name: scheduled-tasks
3description: Use for complex Agent Zero scheduler work, including creating, updating, deleting, running, waiting for, timezone-correcting, or auditing scheduled, planned, and adhoc tasks.
4metadata:
5 source: https://skillmd.com/skills/agent0ai/scheduled-tasks
6---
7
8# Scheduler Tasks
9
10Use the `scheduler` tool to manage saved tasks. Always inspect existing tasks before creating, updating, deleting, or running one.
11
12## Actions
13
14- `list_tasks`: optional `state[]`, `type[]`, `next_run_within`, `next_run_after`
15- `find_task_by_name`: `name`
16- `show_task`: `uuid`
17- `run_task`: `uuid`, optional `context`
18- `update_task`: `uuid`, optional `name`, `system_prompt`, `prompt`, `attachments[]`, `schedule`, `timezone`, `plan[]`, `state`, `dedicated_context`
19- `delete_task`: `uuid`
20- `create_scheduled_task`: `name`, `system_prompt`, `prompt`, optional `attachments[]`, `schedule`, `timezone`, `dedicated_context`
21- `create_adhoc_task`: `name`, `system_prompt`, `prompt`, optional `attachments[]`, `dedicated_context`
22- `create_planned_task`: `name`, `system_prompt`, `prompt`, optional `attachments[]`, `plan[]`, `dedicated_context`
23- `wait_for_task`: `uuid`
24
25## Schedule Fields
26
27Schedules use cron-like fields. Do not put ISO datetimes into `schedule`.
28
29- `minute`
30- `hour`
31- `day`
32- `month`
33- `weekday`
34- `timezone`
35
36Use IANA timezones such as `Europe/Rome`. Omit timezone to use the current user timezone. Planned task datetimes go in `plan`, not `schedule`, and should be ISO strings such as `2026-05-09T18:25:00`.
37
38For one future reminder, prefer `create_planned_task` with:
39
40```json
41{
42 "action": "create_planned_task",
43 "name": "drink water",
44 "prompt": "Remind the user to drink water.",
45 "plan": ["2026-05-11T09:15:00"],
46 "dedicated_context": true
47}
48```
49
50For a recurring or cron-shaped scheduled task, use `create_scheduled_task` with:
51
52```json
53{
54 "action": "create_scheduled_task",
55 "name": "weekday stretch",
56 "prompt": "Remind the user to stretch.",
57 "schedule": {
58 "minute": "15",
59 "hour": "9",
60 "day": "*",
61 "month": "*",
62 "weekday": "1-5",
63 "timezone": "Europe/Rome"
64 },
65 "dedicated_context": true
66}
67```
68
69## Safety
70
71- Do not create recursive task prompts that schedule more tasks.
72- Do not run a task just because it is scheduled; run only if the user asks.
73- Created tasks use a dedicated context unless `dedicated_context` is explicitly `false`.
74- For destructive operations, identify the task by UUID after lookup.
75
76## Example
77
78```json
79{
80 "tool_name": "scheduler",
81 "tool_args": {
82 "action": "find_task_by_name",
83 "name": "daily backup"
84 }
85}
86```