stacks-scheduler

Automate scheduling and execution of background tasks and cron jobs in Stacks applications.

2|Updated Jul 8, 2026
One-click install
npx skills add https://github.com/bughq/bughq --skill stacks-scheduler-bughq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: stacks-scheduler
Source: https://github.com/bughq/bughq/tree/main/.claude/skills/stacks-scheduler
Command: npx skills add https://github.com/bughq/bughq --skill stacks-scheduler-bughq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the complexity of managing background tasks, cron jobs, and automated workflows within a Stacks application, ensuring reliable execution without manual oversight.

Core Features & Use Cases

  • Fluent Scheduling API: Define jobs, actions, and shell commands using a chainable, readable syntax.
  • Advanced Execution Control: Manage task timing with timezone awareness, overlap prevention, and background process spawning.
  • Use Case: Automate recurring maintenance tasks like cleaning up expired sessions or sending weekly reports by defining them in the application scheduler with specific cron intervals and error handling.

Quick Start

Use the stacks-scheduler skill to define a new daily job that executes a specific action at a set time in the America/Los_Angeles timezone.

Frequently Asked Questions about stacks-scheduler

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

FAQPage Schema
How do I schedule background tasks and cron jobs in a Stacks application?

You can schedule background tasks and cron jobs in a Stacks application by using a fluent, type-safe API to define job intervals, actions, and shell commands. This automates execution without manual oversight.

How does overlap prevention work for scheduled cron jobs?

Overlap prevention for scheduled cron jobs works via file-based locking. This mechanism ensures that a new task instance does not start until the previous background process has finished executing.

Can I run timezone-aware task scheduling with Stacks?

Yes, you can run timezone-aware task scheduling with Stacks. The scheduler supports complex timing patterns, allowing you to orchestrate jobs to execute at set times within specific timezones like America/Los_Angeles.

Do I need specific packages to manage task lifecycles and execution intervals?

Yes, managing task lifecycles and execution intervals requires integration with the @stacksjs/scheduler and @stacksjs/cron packages. These dependencies provide the core automation and timing logic for the jobs.

What is the best way to automate recurring maintenance tasks like cleaning up expired sessions?

The best way to automate recurring maintenance tasks like cleaning up expired sessions is to define them in the application scheduler using chainable syntax with specific cron intervals and built-in error handling.