job-scheduler

Manage scheduled background jobs via REST API and APScheduler.

Updated Dec 16, 2025
One-click install
npx skills add https://github.com/adelabdelgawad/meal_request --skill job-scheduler
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: job-scheduler
Source: https://github.com/adelabdelgawad/meal_request/tree/main/.claude/skills/job-scheduler
Command: npx skills add https://github.com/adelabdelgawad/meal_request --skill job-scheduler

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires croniter, and includes scripts (resource) components.

What problem does it solve?

This Skill automates the tedious and error-prone process of managing and executing scheduled tasks, eliminating manual scheduling overhead.

Core Features & Use Cases

  • REST API-driven CRUD: Create, read, update, and delete interval and cron jobs.
  • Execution history & monitoring: Track executions, statuses, durations, and outcomes, with historical cleanup.
  • Distributed coordination: Support multi-instance deployments with locks and heartbeat to prevent duplicate runs.
  • Celery offload: Offload long-running tasks for scalability in heavy workloads.

Quick Start

Create a cron job that runs every day at 02:00 and return its next run time.

Frequently Asked Questions about job-scheduler

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I schedule and manage cron jobs using a FastAPI REST API?

You can manage scheduled cron jobs through REST API-driven CRUD operations by creating, reading, updating, and deleting interval and cron jobs directly via FastAPI endpoints using APScheduler orchestration.

What is the best way to prevent duplicate scheduled task execution in multi-instance Python deployments?

To prevent duplicate scheduled task execution across multi-instance deployments, you can apply distributed coordination using locks and heartbeats to ensure only one instance runs a given background job at a time.

Can I offload long-running scheduled background tasks with Celery and APScheduler?

Yes, you can offload long-running scheduled background tasks to Celery to achieve scalability and prevent heavy workloads from blocking your main FastAPI application process.

How do I track execution history and monitor outcomes for scheduled background jobs?

You can track execution history and monitor scheduled background jobs by persisting execution statuses, durations, and outcomes in a database using SQLAlchemy, alongside historical cleanup features.

Do I need a database to persist scheduled jobs created with APScheduler?

Yes, database persistence using SQLAlchemy is required to store interval and cron job configurations, execution history, and locking states for reliable scheduled task management across restarts.

Does this scheduled task manager support both cron expressions and interval triggers?

Yes, this scheduled task manager supports both cron expressions parsed via croniter and interval triggers, allowing you to create jobs that run at specific times or fixed intervals through a REST API.