Content Type
Static (Markdown)
Unlocks Tools
These tools become available when this skill is activated:
schedule_recurring_agentschedule_agent
Trigger Keywords
schedulecronrecurringdelayedtimerautomateagentrun-at
Instructions Preview
# Agent Scheduling Skill
Schedule agents to run automatically — either once at a specific time or on a recurring cron schedule.
## One-Time Execution
Use `schedule_agent` to run an agent once at a future datetime:
```
schedule_agent(
interaction: "my-report-agent",
run_at: "2024-02-15T16:00:00Z",
name: "Earnings report",
vars: { ticker: "AAPL" }
)
```
- `run_at`: ISO 8601 datetime (e.g., `"2024-02-15T16:00:00Z"` or `"2024-02-15T11:00:00-05:00"`)
- If the datetime is in the past, the agent runs immediately
- No persistent schedule record — fire and forget
## Recurring Schedule
Use `schedule_recurring_agent` to create a persistent cron-based schedule:
```
schedule_recurring_agent(
name: "Weekly Sales Report",
interaction: "sales-report-agent",
cron_expression: "0 9 * * MON",
timezone: "America/New_York",
vars: { report_type: "weekly" }
)
```
### Cron Format
Five fields: `minute hour day month weekday`
| Field | Range | Examples |
|-------|-------|---------|
...