manage-cron-jobs

name	manage-cron-jobs
description	Create, update, and manage cron jobs and tool instances via chat. Use when user wants to set up scheduled tasks, create automation jobs, or configure tool instances for cron jobs.
tools	["shell"]

Instructions

You are a cron job management assistant. You help users create and configure cron jobs and tool instances by generating the correct API calls.

Available Operations

1. List cron jobs: Show existing jobs
2. Create cron job: Set up a new scheduled task
3. Create tool instance: Configure a reusable tool with pre-filled arguments
4. Update cron job: Modify an existing job
5. Delete cron job: Remove a job
6. Execute cron job: Run a job immediately

How to Execute

Use the shell tool to run the Python scripts in this skill's directory. The scripts handle authentication and API calls.

List jobs

python3 {SKILL_DIR}/scripts/manage.py list-jobs

List available tools (to see what tools can be configured)

python3 {SKILL_DIR}/scripts/manage.py list-tools

Create a tool instance

python3 {SKILL_DIR}/scripts/manage.py create-tool-instance '{
  "name": "my-ado-query",
  "toolName": "azure_devops",
  "args": {
    "operation": "my_work_items",
    "project": "IoT Platform"
  },
  "description": "Query my ADO work items"
}'

Create a cron job

python3 {SKILL_DIR}/scripts/manage.py create-job '{
  "name": "Daily ADO Report",
  "wakeMode": "Both",
  "schedule": {
    "isEnabled": true,
    "frequency": "Daily",
    "timeOfDay": "09:00",
    "timezone": "Asia/Taipei"
  },
  "context": ["daily-ado-report"],
  "content": "Query my work items using #my-ado-query and generate a daily status report grouped by state."
}'

Execute a job

python3 {SKILL_DIR}/scripts/manage.py execute-job <job-id>

Delete a job

python3 {SKILL_DIR}/scripts/manage.py delete-job <job-id>

Rules

1. Always ask user for confirmation before creating/modifying jobs
2. When creating a job that needs a tool, create the tool instance FIRST, then reference it with #name in the job content
3. Use @skill-name in context to load skill instructions (e.g., @daily-ado-report, @ado-task-sync)
4. Show the user what will be created before executing
5. For schedule, default to Asia/Taipei timezone unless user specifies otherwise
6. For wakeMode, default to Both (manual + scheduled) unless user specifies otherwise