Cron Builder

Convert natural language to cron expressions and explain complex schedules with run-time projections.

Install
cmdop skills install agensi-cron-builder

Cron Builder is a skill that translates natural language scheduling descriptions into cron expressions and, in reverse, explains existing cron strings in plain English. It is aimed at developers who need to configure background jobs, GitHub Actions workflows, Kubernetes CronJobs, AWS EventBridge rules, or Spring and Quartz schedulers without consulting external documentation or manually counting fields.

The skill handles multiple cron format families. Standard 5-field syntax covers Unix crontab, GitHub Actions, and Kubernetes. Extended 6- and 7-field syntax covers AWS EventBridge, Spring, Quartz, and node-cron, where seconds and years are additional fields. Beyond basic fields, it recognises special characters including L for last day, W for nearest weekday, # for nth weekday of a month, and ? as a blank placeholder — syntax elements that vary across platforms and are a common source of misconfiguration.

Shorthand aliases such as @daily, @weekly, and @hourly are also supported. When producing or explaining a schedule, the skill provides a structured breakdown that includes the next five projected execution times, which helps verify that a schedule behaves as intended before it is deployed. This reduces off-by-one errors and timezone confusion that frequently occur when cron expressions are written by hand or generated by a general-purpose prompt.

Use cases

  • Convert 'every weekday at 9 AM Eastern' into a correctly formatted cron expression for the target platform
  • Paste an existing Quartz cron string and get a human-readable explanation of when it fires
  • Verify a GitHub Actions schedule by checking the next five projected run times
  • Generate an AWS EventBridge 6-field cron expression from a plain-English description
  • Identify the difference between a Unix crontab expression and its Quartz equivalent for the same schedule
  • Produce cron expressions that use advanced special characters like L, W, or # without memorising platform documentation

When to use it

  • Configuring scheduled tasks across Unix, Kubernetes, GitHub Actions, AWS EventBridge, Spring, Quartz, or node-cron
  • When a cron string already exists but its timing is unclear and needs a plain-English breakdown
  • When the target platform uses extended 6- or 7-field syntax that differs from standard Unix crontab
  • When needing to confirm the actual next run times of a schedule before deploying it

When not to use it

  • When the use case requires executing or triggering jobs directly — this skill only generates and explains expressions
  • When schedule management in a platform API is needed rather than expression authoring
  • When no cron-based scheduler is involved and interval-based or event-driven triggers are used exclusively