shift-planner

What problem does it solve?

This Skill automatically builds an employee-by-employee weekly shift schedule from a roster of availability/qualifications and a set of staffing requirements, ensuring hard labor constraints are respected while also producing a coverage and fairness report.

Core Features & Use Cases

• Constraint-aware shift generation (Greedy Assignment): Assigns employees to (day, room, time slot) requirements using hard checks like weekly hour limits, maximum working days, consecutive-day limits, minimum rest hours, and qualification matching.
• Coverage verification at 30-minute granularity: Validates whether each requirement is actually covered in the generated schedule (excluding break periods), and emits alerts for gaps.
• Fairness reporting and alerts: Outputs per-employee fairness metrics (assigned hours vs contract, weekend distribution, avoid-day violations) and highlights imbalances and constraint issues.

Quick Start

Use the shift-planner skill to generate a weekly shift schedule from roster.csv and requirements.csv with 30-minute coverage checks and a fairness report.