task-scheduler_skill

Overview

This skill creates and manages Scheduled Jobs in Windows Task Scheduler using generated PowerShell scripts. It validates requested actions, prepares task metadata, builds a safe, non-elevated script in the system TEMP folder, executes it, and verifies the result with notifications. It enforces consistent naming and runtime rules so tasks are predictable and manageable.

How this skill works

On a create request the skill validates whether requested work can be performed with available tools and rejects unsupported targets (for example, sending email when no mail tool is present). It extracts metadata (prompt, schedule, task name, recurring flag), generates a PowerShell script in the user's TEMP directory that registers a task prefixed with "Agent Tasks -", executes that script (retrying up to five times on error), and verifies creation. For listing and deleting, the skill queries Task Scheduler for tasks with the "Agent Tasks" prefix, presents results, and deletes on confirmed selection.

When to use it

• Schedule one-time or recurring reminders that run when you are logged in
• Automate repeated research or data-save jobs on a local Windows machine
• List all agent-created scheduled jobs for review or cleanup
• Delete an existing agent-created task by selecting from a numbered list
• Create triggers that run a local agent.ps1 with structured prompt and flags

Best practices

• Always include a clear, single-line prompt; convert newlines to \n so the script argument is safe
• Use descriptive titles; the skill will prepend "Agent Tasks -" to every TaskName
• Ensure agent.ps1 exists and use the exact full path; the script validates the file before creating a task
• Keep tasks non-elevated and configured to run only when the user is logged in
• Store and run generated PowerShell scripts only from the system TEMP folder and avoid creating them in a scripts directory

Example use cases

• "Remind me to drink water every hour" → creates a recurring hourly task that runs agent.ps1 with the reminder prompt and delete=0
• "Reminder: pickup my friend at 11:00AM" → creates a one-time task set to run at 11:00 with delete=1
• "List all scheduled tasks" → returns all tasks with the "Agent Tasks" prefix for review
• "Delete scheduled task" → shows a numbered list of Agent Tasks and deletes the selected entry after confirmation
• Schedule periodic research: "Do research on topic X every day at 08:00" → recurring daily job invoking agent.ps1